// operations en masse
Enrichissement d'Entreprises en Masse
Importez un CSV de domaines d'entreprises et enrichissez-les tous avec des donnees detaillees de l'entreprise en une seule fois.
- 01pending
POST /v1/bulk/company201 · { "data": { "id": 1042 } } - 02running
launch: trueprogression interrogée avec GET /v1/bulk/company/1042/progress - 03completed
bulk.completedwebhook signé envoyé à votre webhook_url
GET /v1/bulk/company/1042/download?file=fullFacturé au premier téléchargement · la tâche expire au bout de 180 jours// 01 · entrée
L'entrée d'une tâche Company Enrichment en masse
Importez un CSV de 4 Mo maximum dans l'application, ou envoyez une liste, des lignes ou un fichier à POST /v1/bulk/company. Les colonnes sont détectées à partir de la ligne d'en-tête ; indiquez un index de champ pour en choisir une vous-même.
/bulk/companyColonnesdomain_field_index- Domain
company_name_field_index- Company name
/bulk/companyOptionsinput_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
Une seule requête lance la tâche
Créez-la et lancez-la en un seul appel, puis suivez sa progression ou recevez un événement bulk.completed signé. Chaque ligne de résultat correspond à ce que renvoie 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 · coût et limites
Ce que coûte une tâche
La création ou le lancement d'une tâche ne coûte rien. Son coût est facturé une seule fois, au premier téléchargement des résultats.
// facturation par ligne
1 search credit per company found. Plus 1 per company with phone data.
La facturation des tâches en masse dans la documentation- Lignes : jusqu'à 25,000 par tâche
- 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 · utilisable partout
Lancez des tâches Company Enrichment depuis l'application ou votre code
La même tâche, les mêmes crédits : importez un fichier dans l'application, appelez l'API, ou travaillez depuis un tableur ou un outil no-code.
- API RESTJSON sur HTTPS, 13 SDK, webhooks signés.
GET /v1/companies/find - CSV en masseImportez une liste dans l'application ou envoyez-la en POST à /bulk ; téléchargez-la une fois terminée.
POST /v1/bulk/{type} - Zapier, Make, n8nDes actions no-code pour la recherche, la vérification et l'enrichissement.
Zapier · Make · n8n · Pipedream
La référence complète de la requête : /api/bulk/company-enrichment
// clients
Les équipes qui lancent des tâches 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