Zum Inhalt springen

// post /v1/bulk/company

Bulk Company Enrichment API

Wandle Domain-Listen mit einem asynchronen Bulk-Job in strukturierte Unternehmensintelligenz fur moderne GTM-Teams um.

Domains or company namesBis zu 25,000 Zeilen
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 · anfrage

Massen-Company Enrichment ist eine HTTPS-Anfrage

Senden Sie die Parameter mit Ihrem Schlüssel und Secret. Jedes SDK, die CLI und der MCP-Server stellen genau diesen Aufruf.

type
company
list | data | file
Domains or company names
launch
true startet den Job sofort
webhook_url
Erhält ein signiertes Ereignis, wenn der Job endet
rows
Bis zu 25,000 pro 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 · antwort

Was zurückkommt

JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.

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
  }
}
Jede Zeile, wie GET /companies/find sie zurückgibt
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 und limits

Was ein Aufruf kostet

Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.

// 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

Haufig gestellte Fragen

Noch Fragen? Zum Hilfezentrum

// kostenlos starten

Sehen Sie, wen Tomba in jedem Unternehmen findet

Geben Sie die Domain eines Unternehmens ein und sehen Sie seine Mitarbeitenden, ihre Rollen und verifizierten geschäftlichen E-Mails, jeweils mit den Seiten, auf denen sie gefunden wurden. Kostenloses Konto, keine Karte.