// массовые операции
Массовое обогащение компаний
Загрузите CSV с доменами компаний и обогатите их подробными данными одновременно.
- 01pending
POST /v1/bulk/company201 · { "data": { "id": 1042 } } - 02running
launch: trueход выполнения запрашивается через GET /v1/bulk/company/1042/progress - 03completed
bulk.completedподписанный вебхук доставлен на ваш webhook_url
GET /v1/bulk/company/1042/download?file=fullОплата при первой загрузке · задача хранится 180 дней// 01 · входные данные
Входные данные массовой задачи «Company Enrichment»
Загрузите CSV размером до 4 МБ в приложении или отправьте список, строки или файл на POST /v1/bulk/company. Столбцы определяются по строке заголовков; укажите индекс поля, чтобы выбрать столбец самостоятельно.
/bulk/companyСтолбцыdomain_field_index- Domain
company_name_field_index- Company name
/bulk/companyПараметрыinput_type- domain or company; company when the input has a company name column and no domain column
find_phones- true adds phone numbers, at an extra cost
// 02 · api
Один запрос запускает задачу
Создайте и запустите задачу одним вызовом, затем следите за ходом выполнения или получите подписанное событие bulk.completed. Каждая строка результата — это то, что возвращает GET /companies/find.
curl -X POST "https://api.tomba.io/v1/bulk/company" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Company Enrichment job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/company", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Company Enrichment job",
"list": "piedpiper.com\nshopify.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/company",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Company Enrichment job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"name": "Pied Piper",
"legalName": "Pied Piper, Inc.",
"domain": "piedpiper.com",
"domainAliases": [],
"site": {
"phoneNumbers": [],
"emailAddresses": [
"hello@piedpiper.com"
]
},
"category": {
"sector": "Information Technology",
"industryGroup": "Software & Services",
"industry": "Internet Software & Services",
"subIndustry": "Internet Software & Services",
"sicCode": "73",
"sic4Codes": [
"7372"
],
"naicsCode": "51",
"naics6Codes": [
"511210"
],
"naics6Codes2022": [
"513210"
]
},
"tags": [
"Compression",
"Decentralized internet"
],
"description": "Middle-out compression for files and video.",
"foundedYear": "2014",
"location": "5230 Newell Road, Palo Alto, CA 94303, United States",
"timeZone": "America/Los_Angeles",
"utcOffset": -8,
"geo": {
"streetNumber": "5230",
"streetName": "Newell Road",
"subPremise": null,
"streetAddress": "5230 Newell Road",
"city": "Palo Alto",
"postalCode": "94303",
"state": "California",
"stateCode": "CA",
"country": "United States",
"countryCode": "US",
"lat": 37.4419,
"lng": -122.143
},
"logo": "https://logo.tomba.io/piedpiper.com",
"facebook": {
"handle": null,
"likes": null
},
"linkedin": {
"handle": "company/pied-piper"
},
"twitter": {
"handle": null,
"id": null,
"bio": null,
"followers": null,
"following": null,
"location": null,
"site": null,
"avatar": null
},
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"emailProvider": "Google",
"type": "private",
"ticker": null,
"identifiers": {
"usEIN": null
},
"metrics": {
"alexaUsRank": null,
"alexaGlobalRank": null,
"trafficRank": null,
"employees": "11-50",
"marketCap": null,
"raised": null,
"annualRevenue": null,
"estimatedAnnualRevenue": null,
"fiscalYearEnd": null
},
"indexedAt": "2025-01-15T10:32:00+01:00",
"tech": [
"google_apps",
"intercom"
],
"techCategories": [
"email_hosting_service",
"live_chat"
],
"parent": {
"domain": null
},
"ultimateParent": {
"domain": null
}
},
"meta": {
"domain": "piedpiper.com"
}
}// 03 · стоимость и лимиты
Сколько стоит задача
Создание и запуск задачи бесплатны. Её стоимость списывается один раз — при первой загрузке результатов.
// оплата за строку
1 search credit per company found. Plus 1 per company with phone data.
Оплата массовых задач в документации- Строк: до 25,000 на задачу
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
// 04 · используйте где угодно
Запускайте задачи «Company Enrichment» из приложения или из своего кода
Та же задача, те же кредиты: загрузите файл в приложении, вызовите API или работайте из таблицы или no-code-инструмента.
- REST APIJSON по HTTPS, 13 SDK, подписанные вебхуки.
GET /v1/companies/find - Массовая обработка CSVЗагрузите список в приложении или отправьте его POST-запросом на /bulk; скачайте результат, когда всё будет готово.
POST /v1/bulk/{type} - Zapier, Make, n8nNo-code-действия для поиска, проверки и обогащения.
Zapier · Make · n8n · Pipedream
Полный справочник по запросу: /api/bulk/company-enrichment
// клиенты
Команды, которые запускают задачи «Company Enrichment»
We rely on Tomba to efficiently locate email addresses of key professionals. This allows us to connect directly and build meaningful relationships.
Josh LeierCreative Director, IceHound MarketingTomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, Vizme