// operaciones en masa
Buscador de Autores en Masa
Sube un CSV con URLs de articulos y encuentra todas las direcciones de correo de los autores de una sola vez.
Article URLsHasta 5,000 filas por trabajoCSV, lista o filas
author-finder-list.csv2,500 filas · article urlscompleted
Author Finder masivo · /bulk/author2,500 / 2,500
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: trueprogreso consultado con GET /v1/bulk/author/1042/progress - 03completed
bulk.completedwebhook firmado entregado en tu webhook_url
GET /v1/bulk/author/1042/download?file=fullSe cobra en la primera descarga · el trabajo caduca a los 180 días// 01 · entrada
La entrada de un trabajo masivo de Author Finder
Sube un CSV de hasta 4 MB en la app, o envía una lista, filas o un archivo a POST /v1/bulk/author. Las columnas se detectan a partir de la fila de encabezado; indica un índice de campo para elegir una tú mismo.
POST
/bulk/authorColumnasurl_field_index- Article URL
POST
/bulk/authorOpcionesinclude_sources- true adds the web pages where each address was found
// 02 · api
Una solicitud inicia el trabajo
Créalo y lánzalo en una sola llamada; después sigue su progreso o recibe un evento firmado bulk.completed. Cada fila de resultado es lo que devuelve GET /author-finder.
curl -X POST "https://api.tomba.io/v1/bulk/author" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Author Finder job","list":"https://piedpiper.com/blog/middle-out-compression","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/author", {
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": "Author Finder job",
"list": "https://piedpiper.com/blog/middle-out-compression",
"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/author",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Author Finder job",
"list": "https://piedpiper.com/blog/middle-out-compression",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]POST /bulk/author
201 Created
{
"data": {
"id": 1042
}
}Cada fila, tal como la devuelve GET /author-finder
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
}
],
"info": {
"url": "https://piedpiper.com/blog/middle-out-compression",
"title": "Middle-out compression, explained",
"og_image": "https://piedpiper.com/blog/middle-out-compression/cover.png",
"description": "How middle-out compression reached a Weissman score of 5.2.",
"article_domain": "piedpiper.com",
"publisher_name": "Pied Piper",
"publish_date": "2025-03-04",
"candidates": [
{
"full_name": "Richard Hendricks",
"first_name": "Richard",
"last_name": "Hendricks",
"job_title": "CEO",
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"name_confidence": 0.98,
"score": 0.95,
"count": 3
}
]
}
}
}// 03 · coste y límites
Lo que cuesta un trabajo
Crear o lanzar un trabajo no se cobra. Su coste se cobra una sola vez, en la primera descarga de sus resultados.
// facturación por fila
1 search credit per article with an author address.
Facturación masiva en la documentación- Filas: hasta 5,000 por trabajo
- 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 · úsalo en cualquier parte
Ejecuta trabajos de Author Finder desde la app o tu código
El mismo trabajo, los mismos créditos: sube un archivo en la app, llama a la API o trabaja desde una hoja de cálculo o una herramienta no-code.
- API RESTJSON sobre HTTPS, 13 SDK, webhooks firmados.
GET /v1/author-finder - CSV masivoSube una lista en la app o envíala por POST a /bulk; descárgala cuando termine.
POST /v1/bulk/{type} - Google Sheets y ExcelFórmulas y una barra lateral que llaman a los mismos endpoints.
=TOMBA_AUTHOR(A2) - Zapier, Make, n8nAcciones no-code para el buscador, el verificador y el enriquecimiento.
Zapier · Make · n8n · Pipedream
La referencia completa de la solicitud: /api/bulk/author-finder
// clientes
Equipos que ejecutan trabajos de Author Finder
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, VizmeTomba has been critical to my SEO and cold outreach workflow. None matched Tomba's accuracy or the depth of contact details it returns.
Henry HoeSEO & Sales Outreach Specialist
El Buscador de Autores en Masa es una herramienta especializada para extraer direcciones de correo electronico a partir de una lista de URLs de articulos. Para probar su funcionamiento, se pueden realizar busquedas individuales usando el Buscador de Autores.
El Buscador de Autores obtiene direcciones de correo electronico disponibles publicamente en la web. Para ayudar a determinar la precision de estos correos, a cada uno se le asigna una puntuacion de confianza basada en factores como la credibilidad de la fuente, verificaciones SMTP y el contexto en las paginas web.
El acceso al Buscador de Autores en Masa se obtiene a traves de una cuenta gratuita, con varios planes segun tu necesidad de numero de solicitudes. Es posible realizar una prueba antes de comprometerse con una actualizacion. Puedes subir un archivo CSV para revisar el volumen y la calidad de las direcciones de correo encontradas, estimar el numero de solicitudes necesarias y obtener una vista previa de los datos. Las suscripciones pueden cancelarse en cualquier momento.