How does the Bulk Company Enrichment API work?

Create a bulk operation by uploading company domains, then launch the operation. The API enriches each domain with comprehensive company data asynchronously.

What is the maximum batch size?

You can enrich up to 25,000 company domains per bulk operation. For larger datasets, create multiple bulk operations.

What company data is returned?

Each domain is enriched with company name, description, industry classification (SIC/NAICS codes), location, employee count, revenue estimates, technology stack, and social profiles.

How long does processing take?

يعتمد وقت المعالجة على حجم القائمة وعمليات البحث التي تحتاجها. استعلم عن حالة المهمة أو اضبط Webhook لتُبلَّغ عند انتهائها.

How are credits calculated?

Each domain that returns enrichment data counts as 1 request. Domains with no data found are not counted against your quota.

What technology data is included?

The API detects 6000+ technologies including web frameworks, CMS platforms, analytics tools, cloud providers, and development tools used by each company.

Are webhooks supported?

Yes, configure a webhook URL to receive a notification when your bulk company enrichment operation completes with results ready for download.

How do I download results?

Once processing completes, use the download endpoint to get all enriched company data as CSV or JSON format.

Can I combine this with Domain Search or Email Finder?

Yes. Many teams enrich domains first to qualify target accounts, then run Domain Search and Email Finder only on high-fit companies.

How should I prepare my domain list?

Use root company domains, remove URL paths/subdomains where possible, and deduplicate records before upload for best enrichment coverage.

// post /v1/bulk/company

Bulk Company Enrichment API

Convert domain lists into structured company intelligence with one async bulk job built for modern GTM teams.

احصل على مفتاح API مجاني مرجع API

Domains or company namesحتى 25,000 صف

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 · الطلب

Company Enrichment مجمّع هو طلب HTTPS واحد

أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.

type: company
list | data | file: Domains or company names
launch: القيمة true تبدأ المهمة فورًا
webhook_url: يستقبل حدثًا موقّعًا عند انتهاء المهمة
rows: حتى 25,000 لكل مهمة

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 · الاستجابة

ما يُعاد إليك

JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.

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

كل صف، كما يعيده 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": "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 · التكلفة والحدود

تكلفة الاستدعاء

لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.

// التكلفة

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

Frequently Asked Questions

هل لديك أسئلة أخرى؟ زُر مركز المساعدة

نفّذ أول استدعاء لك في دقيقة

حساب مجاني، ومفتاح API حقيقي، ونقاط النهاية نفسها التي يستخدمها عملاء Enterprise.

1أنشئ حسابًا مجانيًا25 عملية بحث شهريًا. دون بطاقة.

2انسخ مفتاحك وسرّكمن مفاتيح API في لوحة التحكم.

3استدعِ APIالصق الطلب؛ والإجابة بصيغة 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

Company Enrichment مجمّع هو طلب HTTPS واحد

ما يُعاد إليك

تكلفة الاستدعاء

نقاط نهاية ذات صلة

Frequently Asked Questions

نفّذ أول استدعاء لك في دقيقة