// operazioni in blocco
Arricchimento Aziende in Blocco
Carica un CSV di domini aziendali e arricchiscili tutti con dati aziendali dettagliati in una volta sola.
- 01pending
POST /v1/bulk/company201 · { "data": { "id": 1042 } } - 02running
launch: trueavanzamento interrogato con GET /v1/bulk/company/1042/progress - 03completed
bulk.completedwebhook firmato consegnato al tuo webhook_url
GET /v1/bulk/company/1042/download?file=fullAddebitato al primo download · il job scade dopo 180 giorni// 01 · input
L'input di un job Company Enrichment in blocco
Carica nell'app un CSV fino a 4 MB, oppure invia una lista, delle righe o un file a POST /v1/bulk/company. Le colonne vengono individuate dalla riga di intestazione; imposta un indice di campo per sceglierne una tu stesso.
/bulk/companyColonnedomain_field_index- Domain
company_name_field_index- Company name
/bulk/companyOpzioniinput_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 richiesta avvia il job
Crealo e avvialo con una sola chiamata, poi seguine l'avanzamento o ricevi un evento firmato bulk.completed. Ogni riga di risultato è ciò che restituisce 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 · costi e limiti
Quanto costa un job
Creare o avviare un job non costa nulla. Il costo viene addebitato una sola volta, al primo download dei risultati.
// fatturazione per riga
1 search credit per company found. Plus 1 per company with phone data.
Fatturazione dei job in blocco nella documentazione- Righe: fino a 25,000 per job
- 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 · usalo ovunque
Esegui job Company Enrichment dall'app o dal tuo codice
Lo stesso job, gli stessi crediti: carica un file nell'app, chiama l'API o lavora da un foglio di calcolo o da uno strumento no-code.
- API RESTJSON su HTTPS, 13 SDK, webhook firmati.
GET /v1/companies/find - CSV in bloccoCarica una lista nell'app o inviala con POST a /bulk; scaricala quando è pronta.
POST /v1/bulk/{type} - Zapier, Make, n8nAzioni no-code per finder, verifier e arricchimento.
Zapier · Make · n8n · Pipedream
Il riferimento completo della richiesta: /api/bulk/company-enrichment
// clienti
Team che eseguono job 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