// jobs em massa
Processe Milhares de Emails de Uma Vez
Envie arquivos CSV para encontrar, verificar e enriquecer endereços de email em massa. Perfeito para equipes de vendas, profissionais de marketing e equipes de dados.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueprogresso consultado com GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedwebhook assinado entregue no seu webhook_url
GET /v1/bulk/finder/1042/download?file=fullCobrado no primeiro download · o job expira após 180 dias// 01 · tipos de job em massa
Um único modelo de job para todas as listas
Cada tipo de job em massa executa um endpoint da Tomba sobre uma lista, com os mesmos passos de criar, iniciar, acompanhar e baixar.
| Tipo de job em massa | Entrada | API | Máximo de linhas | |
|---|---|---|---|---|
| Massa Domain Search | Domains or company names | POST/bulk/search | 25,000 | |
| Massa Similar Domains | Domains or company names | POST/bulk/similar | 5,000 | |
| Massa Company Enrichment | Domains or company names | POST/bulk/company | 25,000 | |
| Massa Email Finder | Names, with a domain or company name | POST/bulk/finder | 10,000 | |
| Massa Email Enrichment | Email addresses | POST/bulk/enrich | 20,000 | |
| Massa LinkedIn Finder | LinkedIn profile URLs | POST/bulk/linkedin | 20,000 | |
| Massa Author Finder | Article URLs | POST/bulk/author | 5,000 | |
| Massa Email Verifier | Email addresses | POST/bulk/verifier | 20,000 | |
| Massa Phone Finder | Email addresses, LinkedIn URLs or domains | POST/bulk/phone-finder | 10,000 | |
| Massa Phone Validator | Phone numbers, with an optional country | POST/bulk/phone-validator | 10,000 |
Role para o lado para ver todas as colunas
// 02 · ciclo de vida
Como um job em massa é executado
Os mesmos quatro passos no app e pela API.
- 01
Criar
Envie por POST uma lista, linhas ou um CSV de até 4 MB para /v1/bulk/{type}, ou envie o arquivo no app.
- 02
Iniciar
Defina launch: true, ou inicie depois. A Tomba verifica se você tem os créditos de que o job precisa.
- 03
Acompanhar
Consulte o progresso, ou receba um evento bulk.completed assinado no seu webhook_url.
- 04
Baixar
Obtenha os resultados em CSV. O job é cobrado uma única vez, no primeiro download, e expira após 180 dias.
// 03 · limites e cobrança
O que planejar
Os jobs em massa não estão sujeitos aos limites de requisições do plano; eles têm os seus próprios, por workspace.
- 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)
- Charged once, at the first download; later downloads are free
- Jobs em massa na documentação