// operações em massa
Localizador de Autores em Massa
Envie um CSV com URLs de artigos e encontre todos os endereços de email dos autores de uma só vez.
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: trueprogresso consultado com GET /v1/bulk/author/1042/progress - 03completed
bulk.completedwebhook assinado entregue no seu webhook_url
GET /v1/bulk/author/1042/download?file=fullCobrado no primeiro download · o job expira após 180 dias// 01 · entrada
A entrada de um job em massa de Author Finder
Envie um CSV de até 4 MB no app, ou envie uma lista, linhas ou um arquivo para POST /v1/bulk/author. As colunas são identificadas pela linha de cabeçalho; defina um índice de campo para escolher você mesmo.
/bulk/authorColunasurl_field_index- Article URL
/bulk/authorOpçõesinclude_sources- true adds the web pages where each address was found
// 02 · api
Uma requisição inicia o job
Crie e inicie em uma única chamada, depois acompanhe o progresso ou receba um evento bulk.completed assinado. Cada linha de resultado é o que GET /author-finder retorna.
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"]{
"data": {
"id": 1042
}
}{
"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 · custo e limites
Quanto custa um job
Nada é cobrado para criar ou iniciar um job. O custo é cobrado uma única vez, no primeiro download dos resultados.
// cobrança por linha
1 search credit per article with an author address.
Cobrança de jobs em massa na documentação- Linhas: até 5,000 por job
- 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 · use em qualquer lugar
Execute jobs de Author Finder pelo app ou pelo seu código
O mesmo job, os mesmos créditos: envie um arquivo no app, chame a API ou trabalhe a partir de uma planilha ou de uma ferramenta no-code.
- API RESTJSON via HTTPS, 13 SDKs, webhooks assinados.
GET /v1/author-finder - CSV em massaEnvie uma lista no app ou faça POST para /bulk; baixe quando estiver pronta.
POST /v1/bulk/{type} - Google Sheets e ExcelFórmulas e uma barra lateral que chamam os mesmos endpoints.
=TOMBA_AUTHOR(A2) - Zapier, Make, n8nAções no-code para o buscador, o verificador e o enriquecimento.
Zapier · Make · n8n · Pipedream
A referência completa da requisição: /api/bulk/author-finder
// clientes
Equipes que executam jobs 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