¿Cómo funciona la API de búsqueda masiva de dominios?

Cree una operación masiva cargando una lista de dominios de la empresa y luego inicie la operación. La API busca todas las direcciones de correo electrónico asociadas con cada dominio de forma asincrónica.

¿Cuál es el tamaño máximo de lote?

Puede procesar hasta 1000 dominios por operación masiva. Cada dominio devuelve hasta 10 correos electrónicos por búsqueda.

¿Puedo filtrar resultados por departamento?

Sí, puede especificar filtros de departamento (ejecutivo, marketing, recursos humanos, TI, ventas, etc.) y niveles de antigüedad al crear la operación masiva.

¿Qué resultados se devuelven?

Cada dominio devuelve direcciones de correo electrónico encontradas con nombre completo, puesto, departamento, antigüedad, perfil de LinkedIn, puntuación de confianza y fuentes.

¿Cuánto tiempo lleva el procesamiento?

El tiempo de procesamiento depende de la cantidad de dominios. El procesamiento típico es de 2 a 5 segundos por dominio. Un lote de 1000 dominios normalmente se completa en 1 o 2 horas.

¿Cómo se calculan los créditos?

Cada búsqueda de dominio que arroja resultados se cuenta como 1 solicitud para un máximo de 10 correos electrónicos. Los dominios sin resultados encontrados no se cuentan.

¿Se admiten webhooks?

Sí, configure una URL de webhook para recibir una notificación cuando su búsqueda masiva de dominio se complete con el Bulk_id y el estado.

¿Cómo descargo los resultados?

Una vez que se complete el procesamiento, use el punto final de descarga para obtener todos los resultados como CSV o JSON, incluidos todos los correos electrónicos encontrados para cada dominio.

¿Puedo enriquecer los resultados una vez completada la búsqueda de dominio?

Sí. Puede ejecutar los correos electrónicos devueltos a través del Enriquecimiento de correo electrónico masivo o del Verificador de correo electrónico masivo para agregar contexto y mejorar la capacidad de entrega antes de la divulgación.

¿Qué dominios funcionan mejor en búsquedas masivas?

Los dominios comerciales con sitios web activos y presencia de empleados públicos suelen producir una cobertura más sólida. Utilice dominios raíz y elimine duplicados antes del envío.

// post /v1/bulk/search

API de búsqueda masiva de dominios

Descubra correos electrónicos de tomadores de decisiones en cientos de dominios en un trabajo de API asíncrono con resultados listos para exportar.

Obtén tu clave API gratis Referencia de la API

Domains or company namesHasta 25,000 filas

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 · solicitud

Domain Search masivo es una solicitud HTTPS

Envía los parámetros con tu clave y tu secreto. Cada SDK, la CLI y el servidor MCP hacen esta misma llamada.

type: search
list | data | file: Domains or company names
launch: true inicia el trabajo de inmediato
webhook_url: Recibe un evento firmado cuando termina el trabajo
rows: Hasta 25,000 por trabajo

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 · respuesta

Lo que recibes

JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.

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 fila, tal como la devuelve GET /domain-search

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 · coste y límites

Lo que cuesta una llamada

Una llamada solo se cobra en la condición indicada abajo. Los límites de solicitudes dependen de tu plan.

// coste

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)

// preguntas frecuentes

Preguntas frecuentes

¿Tiene más preguntas? Visite el centro de ayuda

Haz tu primera llamada en un minuto

Cuenta gratis, clave API real, los mismos endpoints que usan los clientes Enterprise.

1Crea una cuenta gratis25 búsquedas al mes. Sin tarjeta.

2Copia tu clave y tu secretoDesde Claves API en el panel.

3Llama a la APIPega la solicitud; la respuesta es 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": [] } }

API de búsqueda masiva de dominios

Domain Search masivo es una solicitud HTTPS

Lo que recibes

Lo que cuesta una llamada

Endpoints relacionados

Preguntas frecuentes

Haz tu primera llamada en un minuto