What is the Bulk Company Enrichment?

The Bulk Company Enrichment lets you find Company data from a list of websites. Upload your CSV with domain names and receive enriched company information including industry, size, revenue, and location.

Is the Bulk Company Enrichment free to use?

The Bulk Company Enrichment requires a Free account. You can choose the right plan for you, depending on the number of requests you need. You can try out the Bulk Company Enrichment before upgrading your account. Upload your CSV to see how many email addresses we find, the average data quality, how many requests you'll need, and a preview of the data. You can cancel your subscription at any time.

// bulk operations

Bulk Company Enrichment

Upload a CSV of company domains and enrich them all with detailed company data at once.

Start Bulk Processing View API

Domains or company namesUp to 25,000 rows a jobCSV, list or rows

company-enrichment-list.csv2,500 rows · domains or company namescompleted

Bulk Company Enrichment · /bulk/company2,500 / 2,500

01pendingPOST /v1/bulk/company201 · { "data": { "id": 1042 } }
02runninglaunch: trueprogress polled with GET /v1/bulk/company/1042/progress
03completedbulk.completedsigned webhook delivered to your webhook_url

GET /v1/bulk/company/1042/download?file=fullCharged at the first download · the job expires after 180 days

// 01 · input

The input of a bulk Company Enrichment job

Upload a CSV of up to 4 MB in the app, or send a list, rows or a file to POST /v1/bulk/company. Columns are found from the header row; set a field index to choose one yourself.

POST/bulk/companyColumns

domain_field_index: Domain
company_name_field_index: Company name

POST/bulk/companyOptions

input_type: domain or company; company when the input has a company name column and no domain column
find_phones: true adds phone numbers, at an extra cost

// 02 · api

One request starts the job

Create and launch it in one call, then follow its progress or receive a signed bulk.completed event. Each result row is what GET /companies/find returns.

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

POST /bulk/company

201 Created

{
  "data": {
    "id": 1042
  }
}

Each row, as GET /companies/find returns it

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 · cost and limits

What a job costs

Nothing is charged to create or launch a job. Its cost is charged once, at the first download of its results.

// billing per row

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

Bulk billing in the docs

Rows: up to 25,000 per job
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)

// 04 · use it anywhere

Run Company Enrichment jobs from the app or your code

The same job, the same credits: upload a file in the app, call the API, or work from a spreadsheet or a no-code tool.

The full request reference: /api/bulk/company-enrichment

// customers

Teams that run Company Enrichment jobs

We rely on Tomba to efficiently locate email addresses of key professionals. This allows us to connect directly and build meaningful relationships.
Josh LeierCreative Director, IceHound Marketing
Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, Vizme

// faq

Frequently Asked Questions

Still have questions? Visit the help center