// operações em massa
Domínios Similares em Massa
Envie um CSV com domínios e encontre empresas similares para cada um de uma só vez.
- 01pending
POST /v1/bulk/similar201 · { "data": { "id": 1042 } } - 02running
launch: trueprogresso consultado com GET /v1/bulk/similar/1042/progress - 03completed
bulk.completedwebhook assinado entregue no seu webhook_url
GET /v1/bulk/similar/1042/download?file=fullCobrado no primeiro download · o job expira após 180 dias// 01 · entrada
A entrada de um job em massa de Similar Domains
Envie um CSV de até 4 MB no app, ou envie uma lista, linhas ou um arquivo para POST /v1/bulk/similar. As colunas são identificadas pela linha de cabeçalho; defina um índice de campo para escolher você mesmo.
/bulk/similarColunasdomain_field_index- Domain
company_name_field_index- Company name
/bulk/similarOpçõesinput_type- domain or company; company when the input has a company name column and no domain column
max_emails_per_domain- Addresses per domain: 1, 10 (the default), 20, 50 or 100
// 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 /similar retorna.
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains 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/similar", {
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": "Similar Domains 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/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": [
{
"website_url": "hooli.com",
"name": "Hooli",
"industries": "internet"
},
{
"website_url": "endframe.com",
"name": "Endframe",
"industries": "computer software"
}
],
"meta": {
"total": 2,
"pageSize": 10,
"current": 1,
"total_pages": 1,
"params": {
"domain": "piedpiper.com",
"page": 1,
"limit": 10
}
}
}// 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 domain with at least one similar company.
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 Similar Domains 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/email-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_VERIFY(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/domain-similar
// clientes
Equipes que executam jobs de Similar Domains
We use Tomba to find emails of the right people, helping us reach out and grow our network easily.
Olderico A.F. CavigliaCEO, StrategycappSince years, Tomba has provided the most results per search, and it keeps getting better. It recently became one of the most feature-rich tools for our list building.
Steffen BurandtHead of Business Development, Chandler Orchards