Direct naar de inhoud

// post /v1/bulk/company

Bulk Company Enrichment API

Zet domeinlijsten om in gestructureerde bedrijfsinformatie met één asynchrone bulkjob, gemaakt voor moderne GTM-teams.

Domains or company namesTot 25,000 rijen
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 · verzoek

Bulk Company Enrichment is één HTTPS-verzoek

Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.

type
company
list | data | file
Domains or company names
launch
true start de taak meteen
webhook_url
Ontvangt een ondertekend event als de taak klaar is
rows
Tot 25,000 per taak
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 · antwoord

Wat je terugkrijgt

JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.

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
  }
}
Elke rij, zoals GET /companies/find die teruggeeft
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 · kosten en limieten

Wat een aanroep kost

Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.

// kosten

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

Veelgestelde vragen

Nog vragen? Bezoek het helpcentrum

// gratis beginnen

Zie wie Tomba vindt bij elk bedrijf

Typ het domein van een bedrijf en zie de mensen, hun functies en geverifieerde zakelijke e-mails, elk met de pagina's waarop ze zijn gevonden. Gratis account, geen creditcard.