// operaciones en masa
Enriquecimiento de Empresas en Masa
Sube un CSV con dominios de empresas y enriquecelos todos con datos detallados de la empresa de una sola vez.
- 01pending
POST /v1/bulk/company201 · { "data": { "id": 1042 } } - 02running
launch: trueprogreso consultado con GET /v1/bulk/company/1042/progress - 03completed
bulk.completedwebhook firmado entregado en tu webhook_url
GET /v1/bulk/company/1042/download?file=fullSe cobra en la primera descarga · el trabajo caduca a los 180 días// 01 · entrada
La entrada de un trabajo masivo de Company Enrichment
Sube un CSV de hasta 4 MB en la app, o envía una lista, filas o un archivo a POST /v1/bulk/company. Las columnas se detectan a partir de la fila de encabezado; indica un índice de campo para elegir una tú mismo.
/bulk/companyColumnasdomain_field_index- Domain
company_name_field_index- Company name
/bulk/companyOpcionesinput_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
Una solicitud inicia el trabajo
Créalo y lánzalo en una sola llamada; después sigue su progreso o recibe un evento firmado bulk.completed. Cada fila de resultado es lo que devuelve 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 · coste y límites
Lo que cuesta un trabajo
Crear o lanzar un trabajo no se cobra. Su coste se cobra una sola vez, en la primera descarga de sus resultados.
// facturación por fila
1 search credit per company found. Plus 1 per company with phone data.
Facturación masiva en la documentación- Filas: hasta 25,000 por trabajo
- 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 · úsalo en cualquier parte
Ejecuta trabajos de Company Enrichment desde la app o tu código
El mismo trabajo, los mismos créditos: sube un archivo en la app, llama a la API o trabaja desde una hoja de cálculo o una herramienta no-code.
- API RESTJSON sobre HTTPS, 13 SDK, webhooks firmados.
GET /v1/companies/find - CSV masivoSube una lista en la app o envíala por POST a /bulk; descárgala cuando termine.
POST /v1/bulk/{type} - Zapier, Make, n8nAcciones no-code para el buscador, el verificador y el enriquecimiento.
Zapier · Make · n8n · Pipedream
La referencia completa de la solicitud: /api/bulk/company-enrichment
// clientes
Equipos que ejecutan trabajos de 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