Vai al contenuto

// post /v1/bulk/company

API Bulk Company Enrichment

Converti elenchi di domini in informazioni aziendali strutturate con un solo job bulk asincrono, pensato per i team GTM moderni.

Domains or company namesFino a 25,000 righe
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"}'

// 01 · richiesta

Company Enrichment in blocco è una sola richiesta HTTPS

Invia i parametri con la tua chiave e il tuo secret. Ogni SDK, la CLI e il server MCP fanno questa stessa chiamata.

type
company
list | data | file
Domains or company names
launch
true avvia subito il job
webhook_url
Riceve un evento firmato quando il job termina
rows
Fino a 25,000 per job
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"}'

// 02 · risposta

Cosa ricevi

JSON, uguale in ogni linguaggio. I campi che Tomba non conosce sono null, mai indovinati.

GET/companies/find
data.name, data.legalName, data.domainstring | null
Who the company is
data.description, data.foundedYear, data.typestring | null
What it does, when it was founded, its ownership
data.categoryobject
Sector, industry, SIC and NAICS codes
data.geoobject
Street address, city, state, country, coordinates
data.metricsobject
Employees, traffic rank, revenue, funding
data.linkedin, data.twitter, data.facebookobject
Social handles
data.tech[], data.techCategories[]array | null
Technologies the website runs
meta.domainstring | null
The domain you sent
errorsobject
When nothing is found the response is still 200, with errors {type, message, code} instead of data
POST /bulk/company
201 Created
{
  "data": {
    "id": 1042
  }
}
Ogni riga, come la restituisce GET /companies/find
200 OK
{
  "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 una chiamata

Una chiamata viene addebitata solo alla condizione indicata sotto. I limiti di frequenza dipendono dal tuo piano.

// costo

1 search credit per company found. Plus 1 per company with phone data.

Charged once, at the first download; later downloads are free

  • 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)

// faq

Domande frequenti

Ha altre domande? Visita il centro assistenza

// inizia gratis

Scopri chi trova Tomba in qualsiasi azienda

Digita il dominio di un'azienda per vedere le sue persone, i loro ruoli e le email di lavoro verificate, ciascuna con le pagine in cui è stata trovata. Account gratuito, senza carta.