Como funciona la API de Enriquecimiento de Empresas en Lote?

Crea una operacion en lote subiendo dominios de empresas y luego inicia la operacion. La API enriquece cada dominio de forma asincrona con datos empresariales completos.

Cual es el tamano maximo del lote?

Puedes enriquecer hasta 25,000 dominios por operacion en lote. Para datasets mas grandes, crea varias operaciones.

Que datos de empresa devuelve?

Cada dominio se enriquece con nombre de la empresa, descripcion, clasificacion industrial (codigos SIC/NAICS), ubicacion, numero de empleados, ingresos estimados, stack tecnologico y perfiles sociales.

Cuanto tarda el procesamiento?

El tiempo de procesamiento depende del tamaño de la lista y de las búsquedas que requiera. Consulte el estado del trabajo o configure un webhook para saber cuándo termina.

Como se calculan los creditos?

Cada dominio que devuelve datos de enriquecimiento cuenta como 1 solicitud. Los dominios sin datos encontrados no se descuentan de tu cuota.

Que datos tecnologicos se incluyen?

La API detecta mas de 6000 tecnologias, incluyendo frameworks web, plataformas CMS, herramientas de analitica, proveedores cloud y herramientas de desarrollo usadas por cada empresa.

Si, configura una URL de webhook para recibir una notificacion cuando tu operacion de enriquecimiento de empresas en lote finalice y los resultados esten listos para descargar.

Como descargo los resultados?

Cuando el procesamiento termine, usa el endpoint de descarga para obtener todos los datos enriquecidos en formato CSV o JSON.

Puedo combinar esto con Domain Search o Email Finder?

Si. Muchos equipos primero enriquecen dominios para calificar cuentas objetivo y despues ejecutan Domain Search y Email Finder solo en empresas con alto fit.

Como debo preparar mi lista de dominios?

Usa dominios raiz de empresa, elimina rutas de URL/subdominios cuando sea posible y quita duplicados antes de subir para obtener la mejor cobertura.

// post /v1/bulk/company

API de Enriquecimiento de Empresas en Lote

Convierte listas de dominios en inteligencia empresarial estructurada con un trabajo async en lote, creado para equipos GTM modernos.

Obtén tu clave API gratis Referencia de la API

Domains or company namesHasta 25,000 filas

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

Company Enrichment 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: company
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/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 · respuesta

Lo que recibes

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

GET/companies/findCampo

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

Cada fila, tal como la devuelve 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 · 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

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

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 Enriquecimiento de Empresas en Lote

Company Enrichment masivo es una solicitud HTTPS

Lo que recibes

Lo que cuesta una llamada

Endpoints relacionados

Preguntas Frecuentes

Haz tu primera llamada en un minuto