// post /v1/bulk/enrich
API de enriquecimiento de correo electrónico masivo
Transforme listas de correo electrónico sin procesar en inteligencia de contactos procesable mediante una operación API asincrónica de alto rendimiento.
Email addressesHasta 20,000 filas
curl -X POST "https://api.tomba.io/v1/bulk/enrich" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Enrichment job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/enrich", {
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": "Email Enrichment job",
"list": "richard@piedpiper.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/enrich",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Enrichment job",
"list": "richard@piedpiper.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · solicitud
Email 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
- enrich
- list | data | file
- Email addresses
- launch
- true inicia el trabajo de inmediato
- webhook_url
- Recibe un evento firmado cuando termina el trabajo
- rows
- Hasta 20,000 por trabajo
curl -X POST "https://api.tomba.io/v1/bulk/enrich" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Enrichment job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/enrich", {
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": "Email Enrichment job",
"list": "richard@piedpiper.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/enrich",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Enrichment job",
"list": "richard@piedpiper.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
/enrichCampodata.emailstring | null- The address, or null when none is found
data.scoreinteger- Confidence from 0 to 100
data.verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null- Name, job title and team
data.typestring | null- personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null- Public profiles
data.sources[]array | null- Up to 20 public pages where the address was found, with dates
data.company, data.website_urlstring | null- The company and its domain
data.disposable, data.webmailboolean- The address is on a disposable or webmail domain
data.accept_allboolean | null- The domain accepts mail for any address (catch-all)
data.phone_numberboolean- Tomba holds a phone number for the person
data.phone_data[]array- The numbers, when you send enrich_mobile (each as in Phone Finder)
POST /bulk/enrich
201 Created
{
"data": {
"id": 1042
}
}Cada fila, tal como la devuelve GET /enrich
200 OK
{
"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
}
],
"disposable": false,
"webmail": false,
"phone_data": []
}
}// 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 row with a result. Plus 5 per row 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)
Cree una operación masiva cargando direcciones de correo electrónico y luego inicie la operación. La API enriquece cada correo electrónico con datos de personas y empresas de forma asíncrona.
Puede enriquecer hasta 10.000 direcciones de correo electrónico por operación masiva. Para conjuntos de datos más grandes, cree varias operaciones masivas.
Cada correo electrónico se enriquece con datos personales (nombre, cargo, ubicación, perfiles sociales) y datos de la empresa (nombre, industria, tamaño, tecnología, perfiles sociales).
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.
Cada correo electrónico que devuelve datos de enriquecimiento cuenta como 1 solicitud. Los correos electrónicos sin datos encontrados no se cuentan en su cuota.
Sí, el enriquecimiento masivo devuelve datos a nivel de persona (nombre, función, perfiles sociales) y datos a nivel de empresa (industria, tamaño, pila tecnológica) para cada correo electrónico.
Sí, configure una URL de webhook para recibir una notificación cuando su operación de enriquecimiento masivo se complete con los resultados listos para descargar.
Los datos se actualizan continuamente a partir de fuentes públicas. Cada registro incluye marcas de tiempo que muestran cuándo se verificaron los datos por última vez.
Para tuberías de la más alta calidad, verifique primero su lista. Eliminar los correos electrónicos no válidos antes del enriquecimiento ayuda a mejorar las tasas de coincidencia y mantiene limpios los flujos de trabajo posteriores.
Sí. La mayoría de los equipos utilizan el punto final de descarga masiva y luego sincronizan los campos enriquecidos con CRM, automatización de marketing o canales de almacén.