Wie funktioniert die Bulk Company Enrichment API?

Erstelle eine Bulk-Operation, indem du Unternehmensdomains hochladst, und starte dann die Operation. Die API reichert jede Domain asynchron mit umfassenden Unternehmensdaten an.

Wie gross ist die maximale Batch-Grosse?

Du kannst bis zu 25,000 Unternehmensdomains pro Bulk-Operation anreichern. Fur grossere Datensatze erstelle mehrere Bulk-Operationen.

Welche Unternehmensdaten werden zuruckgegeben?

Jede Domain wird mit Unternehmensname, Beschreibung, Branchenklassifizierung (SIC/NAICS-Codes), Standort, Mitarbeiterzahl, Umsatzschatzung, Technologie-Stack und Social-Profilen angereichert.

Wie lange dauert die Verarbeitung?

Die Bearbeitungszeit hängt von der Größe der Liste und den nötigen Abfragen ab. Fragen Sie den Status des Jobs ab oder richten Sie einen Webhook ein, um zu erfahren, wann er abgeschlossen ist.

Wie werden Credits berechnet?

Jede Domain, die Anreicherungsdaten zuruckgibt, zahlt als 1 Anfrage. Domains ohne gefundene Daten werden nicht von deinem Kontingent abgezogen.

Welche Technologiedaten sind enthalten?

Die API erkennt uber 6000 Technologien, darunter Web-Frameworks, CMS-Plattformen, Analytics-Tools, Cloud-Provider und Development-Tools, die von jedem Unternehmen genutzt werden.

Werden Webhooks unterstutzt?

Ja, konfiguriere eine Webhook-URL, um benachrichtigt zu werden, wenn deine Bulk-Unternehmensanreicherung abgeschlossen ist und die Ergebnisse zum Download bereitstehen.

Wie lade ich die Ergebnisse herunter?

Sobald die Verarbeitung abgeschlossen ist, nutze den Download-Endpoint, um alle angereicherten Unternehmensdaten als CSV oder JSON zu erhalten.

Kann ich das mit Domain Search oder Email Finder kombinieren?

Ja. Viele Teams reichern Domains zuerst an, um Zielaccounts zu qualifizieren, und nutzen danach Domain Search und Email Finder nur fur Unternehmen mit hohem Fit.

Wie sollte ich meine Domain-Liste vorbereiten?

Verwende Root-Unternehmensdomains, entferne wenn moglich URL-Pfade/Subdomains und dedupliziere Datensatze vor dem Upload fur die beste Anreicherungsabdeckung.

// post /v1/bulk/company

Bulk Company Enrichment API

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

Kostenlosen API-Schlüssel holen API-Referenz

Domains or company namesBis zu 25,000 Zeilen

POST /bulk/company

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"]

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

POST /bulk/company

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"]

// 02 · antwort

Was zurückkommt

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

GET/companies/findFeld

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": "Pied Piper builds middle-out compression for files, video and a decentralized internet.",
    "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

Ihr erster Aufruf in einer Minute

Kostenloses Konto, echter API-Schlüssel, dieselben Endpunkte, die Enterprise-Kunden nutzen.

1Kostenloses Konto erstellen25 Suchen pro Monat. Keine Kreditkarte.

2Schlüssel und Secret kopierenUnter API-Schlüssel im Dashboard.

3Die API aufrufenFügen Sie die Anfrage ein; die Antwort ist JSON.

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY } }); const { data } = await res.json();

import os, requests res = requests.get( "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", headers={ "X-Tomba-Key": os.environ["TOMBA_API_KEY"], "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"], }, ) data = res.json()["data"]

{ "data": { "email": "richard@piedpiper.com", "first_name": "Richard", "last_name": "Hendricks", "full_name": "Richard Hendricks", "website_url": "piedpiper.com", "company": "Pied Piper", "pattern": "{first}", "department": "executive", "type": "personal", "position": "CEO", "country": "US", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/richard-hendricks", "score": 100, "accept_all": false, "phone_number": true, "verification": { "date": "2025-01-15T10:32:00+01:00", "status": "valid" }, "sources": [ { "uri": "https://piedpiper.com/blog/engineering", "website_url": "piedpiper.com", "extracted_on": "2024-06-01T09:14:07+01:00", "last_seen_on": "2025-01-10T17:02:44+01:00", "still_on_page": true } ], "phone_data": [] } }

Bulk Company Enrichment API

Massen-Company Enrichment ist eine HTTPS-Anfrage

Was zurückkommt

Was ein Aufruf kostet

Verwandte Endpunkte

Haufig gestellte Fragen

Ihr erster Aufruf in einer Minute