Pular para o conteúdo

// operações em massa

Verificador de Emails em Massa

Envie um CSV com endereços de email e verifique todos quanto à entregabilidade de uma só vez.

Email addressesAté 20,000 linhas por jobCSV, lista ou linhas
email-verifier-list.csv2,500 linhas · email addressescompleted
Massa Email Verifier · /bulk/verifier2,500 / 2,500
  1. 01pendingPOST /v1/bulk/verifier201 · { "data": { "id": 1042 } }
  2. 02runninglaunch: trueprogresso consultado com GET /v1/bulk/verifier/1042/progress
  3. 03completedbulk.completedwebhook assinado entregue no seu webhook_url
GET /v1/bulk/verifier/1042/download?file=fullCobrado no primeiro download · o job expira após 180 dias

// 01 · entrada

A entrada de um job em massa de Email Verifier

Envie um CSV de até 4 MB no app, ou envie uma lista, linhas ou um arquivo para POST /v1/bulk/verifier. As colunas são identificadas pela linha de cabeçalho; defina um índice de campo para escolher você mesmo.

POST/bulk/verifierColunas
email_field_index
Email address
POST/bulk/verifierOpções
find_phones
true adds phone numbers, at an extra cost
include_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 /email-verifier retorna.

curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'
POST /bulk/verifier
201 Created
{
  "data": {
    "id": 1042
  }
}
Cada linha, como GET /email-verifier a retorna
200 OK
{
  "data": {
    "email": {
      "email": "richard@piedpiper.com",
      "result": "deliverable",
      "status": "valid",
      "score": 99,
      "smtp_provider": "Google",
      "mx": {
        "records": [
          "aspmx.l.google.com",
          "alt1.aspmx.l.google.com"
        ]
      },
      "mx_check": true,
      "smtp_server": true,
      "smtp_check": true,
      "accept_all": false,
      "greylisted": false,
      "block": false,
      "gibberish": false,
      "disposable": false,
      "webmail": false,
      "regex": true,
      "whois": {
        "registrar_name": null,
        "referral_url": null,
        "created_date": null
      }
    },
    "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
      }
    ],
    "phone_data": null
  }
}

// 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 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.

Cobrança de jobs em massa na documentação
  • Linhas: até 20,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)

// clientes

Equipes que executam jobs de Email Verifier

  • Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
    Nuno PoçoSales Automation Architect, clickworks.io
  • The data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
    Benjie MalinaoCo-Founder & CTO, Channel Automation

// faq

Perguntas Frequentes

Ainda tem dúvidas? Visite a central de ajuda

// início rápido

Faça sua primeira chamada em um minuto

Conta gratuita, chave de API real, os mesmos endpoints que os clientes Enterprise usam.

  1. 1Crie uma conta gratuita25 buscas por mês. Sem cartão.
  2. 2Copie sua chave e seu secretEm Chaves de API, no painel.
  3. 3Chame a APICole a requisição; a resposta vem em JSON.
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Resposta
200 OK· 1 search credit
{
  "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
      }
    ],
    "phone_data": []
  }
}