How does the Bulk Domain Search API work?

Create a bulk operation by uploading a list of company domains, then launch the operation. The API searches for all email addresses associated with each domain asynchronously.

What is the maximum batch size?

You can process up to 25,000 domains per bulk operation. Each domain returns up to 10 emails per search.

Can I filter results by department?

Yes, you can specify department filters (executive, marketing, HR, IT, sales, etc.) and seniority levels when creating the bulk operation.

What results are returned?

Each domain returns found email addresses with full name, position, department, seniority, LinkedIn profile, confidence score, and sources.

How long does processing take?

Processing time depends on the number of domains. Typical processing is 2-5 seconds per domain. A batch of 25,000 domains typically completes within 1-2 hours.

How are credits calculated?

Each domain search that returns results is counted as 1 request for up to 10 emails. Domains with no results found are not counted.

Are webhooks supported?

Yes, configure a webhook URL to receive a notification when your bulk domain search completes with the bulk_id and status.

How do I download results?

Once processing completes, use the download endpoint to get all results as CSV or JSON, including all emails found for each domain.

Can I enrich results after Domain Search completes?

Yes. You can run returned emails through Bulk Email Enrichment or Bulk Email Verifier to add context and improve deliverability before outreach.

What domains perform best in bulk searches?

Business domains with active websites and public employee footprints usually produce stronger coverage. Use root domains and remove duplicates before submission.

// post /v1/bulk/search

Bulk Domain Search API

Discover decision-maker emails across hundreds of domains in one asynchronous API job with export-ready results.

Obter chave de API grátis Referência da API

Domains or company namesAté 25,000 linhas

POST /bulk/search

curl -X POST "https://api.tomba.io/v1/bulk/search" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

const res = await fetch("https://api.tomba.io/v1/bulk/search", {
  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": "Domain Search job",
    "list": "piedpiper.com\nshopify.com\nnotion.so",
    "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/search",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Domain Search job",
      "list": "piedpiper.com\nshopify.com\nnotion.so",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

// 01 · requisição

Massa Domain Search é uma requisição HTTPS

Envie os parâmetros com sua chave e seu secret. Todos os SDKs, a CLI e o servidor MCP fazem esta mesma chamada.

type: search
list | data | file: Domains or company names
launch: true inicia o job imediatamente
webhook_url: Recebe um evento assinado quando o job termina
rows: Até 25,000 por job

POST /bulk/search

curl -X POST "https://api.tomba.io/v1/bulk/search" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

const res = await fetch("https://api.tomba.io/v1/bulk/search", {
  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": "Domain Search job",
    "list": "piedpiper.com\nshopify.com\nnotion.so",
    "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/search",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Domain Search job",
      "list": "piedpiper.com\nshopify.com\nnotion.so",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

// 02 · resposta

O que volta

JSON, igual em todas as linguagens. Campos que a Tomba não conhece vêm como null, nunca adivinhados.

GET/domain-searchCampo

data.organizationobject: Company name, location, social links, industry, size, revenue, description, pattern
data.organization.accept_allboolean: The domain accepts mail for any address (catch-all)
data.emails[].emailstring: Each address found
data.emails[].full_name, data.emails[].position, data.emails[].departmentstring | null: Name, job title and team
data.emails[].senioritystring | null: junior, senior or executive
data.emails[].scoreinteger: Confidence from 0 to 100
data.emails[].verification.statusstring | null: valid, accept_all, invalid or unknown, with verification.date
data.emails[].sources[]array: Where each address was found
meta.total, meta.total_pagesinteger: Addresses that match, and pages at this pageSize
meta.current, meta.pageSizeinteger: This page and its size
meta.paramsobject: The parameters the search ran with

POST /bulk/search

201 Created

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

Cada linha, como GET /domain-search a retorna

200 OK

{
  "data": {
    "organization": {
      "website_url": "piedpiper.com",
      "organization": "Pied Piper",
      "location": {
        "country": "US",
        "city": "Palo Alto",
        "state": "CA",
        "street_address": "5230 Newell Road",
        "postal_code": "94303"
      },
      "social_links": {
        "twitter_url": null,
        "facebook_url": null,
        "instagram_url": null,
        "linkedin_url": "https://www.linkedin.com/company/pied-piper",
        "github_url": null,
        "youtube_url": null,
        "pinterest_url": null,
        "tiktok_url": null
      },
      "disposable": false,
      "webmail": false,
      "phone_number": false,
      "industries": "computer software",
      "founded": "2014",
      "company_size": "11-50",
      "company_type": "privately held",
      "revenue": null,
      "accept_all": false,
      "description": "Pied Piper builds middle-out compression for files, video and a decentralized internet.",
      "pattern": "{first}",
      "total_similar": 2,
      "keywords": [
        "compression",
        "middle-out",
        "decentralized internet"
      ],
      "ranking": null,
      "whois": {
        "registrar_name": null,
        "created_date": null,
        "referral_url": null
      },
      "last_updated": "2025-01-15T10:32:00+01:00"
    },
    "emails": [
      {
        "email": "dinesh@piedpiper.com",
        "first_name": "Dinesh",
        "last_name": "Chugtai",
        "full_name": "Dinesh Chugtai",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Software Engineer",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 99,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "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
          }
        ]
      },
      {
        "email": "gilfoyle@piedpiper.com",
        "first_name": "Bertram",
        "last_name": "Gilfoyle",
        "full_name": "Bertram Gilfoyle",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "US",
        "position": "Systems Architect",
        "department": "engineering",
        "seniority": "senior",
        "twitter": null,
        "linkedin": null,
        "score": 97,
        "verification": {
          "date": "2025-01-15T10:32:00+01:00",
          "status": "valid"
        },
        "phone_data": [],
        "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
          }
        ]
      }
    ]
  },
  "meta": {
    "total": 12,
    "pageSize": 10,
    "current": 1,
    "total_pages": 2,
    "params": {
      "domain": "piedpiper.com",
      "company": "",
      "page": 1,
      "limit": 10,
      "department": "engineering",
      "country": null,
      "type": "all",
      "live": false,
      "enrich_mobile": false,
      "webhook_url": null
    }
  }
}

// 03 · custo e limites

Quanto custa uma chamada

Uma chamada só é cobrada na condição abaixo. Os limites de requisições dependem do seu plano.

// custo

Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address 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

Ainda tem dúvidas? Visite a central de ajuda

Faça sua primeira chamada em um minuto

Conta gratuita, chave de API real, os mesmos endpoints que os clientes Enterprise usam.

1Crie uma conta gratuita25 buscas por mês. Sem cartão.

2Copie sua chave e seu secretEm Chaves de API, no painel.

3Chame a APICole a requisição; a resposta vem em 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 Domain Search API

Massa Domain Search é uma requisição HTTPS

O que volta

Quanto custa uma chamada

Endpoints relacionados

Frequently Asked Questions

Faça sua primeira chamada em um minuto