Pular para o conteúdo
Página inicial da Tomba
Comece grátis

// plataforma para desenvolvedores

API Poderosa para Inteligencia de Email

Integre busca, verificacao e enriquecimento de email nas suas aplicacoes. API RESTful com SDKs para todas as principais linguagens.

Obter chave de API grátisReferência da API
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
GETapi.tomba.io/v1/domain-search
Exemplo
organization.organization
Pied Piper
organization.industries
computer software
organization.company_size
11-50
organization.pattern
{first}
organization.accept_all
false
emails
2 items
emails[0].email
dinesh@piedpiper.com
emails[0].position
Software Engineer
emails[0].verification.status
valid

// 01 · endpoints

Cada endpoint, seu custo e sua página de referência

REST via HTTPS, JSON na entrada e na saída, dois cabeçalhos para autenticação. URL base https://api.tomba.io/v1.

GET/email-finderA person's work email from their name and company domainCusto:1 search creditCobrado quando:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profileCusto:1 search credit per 10 resultsCobrado quando:At least one address is returned. 1 credit per 10 results requested with limit.
GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checksCusto:1 verification creditCobrado quando:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profilesCusto:1 search creditCobrado quando:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URLCusto:1 search creditCobrado quando:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an articleCusto:1 search creditCobrado quando:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URLCusto:5 search creditsCobrado quando:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and regionCusto:1 search creditCobrado quando:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filtersCusto:1 search creditCobrado quando:At least one company is returned.
GET/combined/findThe person and their company from one email addressCusto:2 search creditsCobrado quando:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socialsCusto:1 search creditCobrado quando:A company is returned.
GET/technologyThe technologies a website runs, by categoryCusto:FreeCobrado quando:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniorityCusto:1 email count creditCobrado quando:Every call.
GET/similarCompanies similar to a domain, with their industryCusto:1 search credit per 10 resultsCobrado quando:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their shareCusto:1 email count creditCobrado quando:Every successful call, including an empty result.
GET/locationWhere a company's people are, by countryCusto:1 email count creditCobrado quando:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handlesCusto:1 search creditCobrado quando:A person is returned.
URL base https://api.tomba.io/v1 · Envie X-Tomba-Key e X-Tomba-Secret em cada requisição.Todos os endpoints na referência da API

// 02 · em massa

Jobs em massa para listas de até 25.000 linhas

Envie por POST uma lista, linhas ou um CSV para /bulk/, receba um webhook assinado quando terminar e pague uma única vez no primeiro download.

Tipo de job em massaEntradaMáximo de linhas
POST/bulk/searchDomains or company names25,000
POST/bulk/similarDomains or company names5,000
POST/bulk/companyDomains or company names25,000
POST/bulk/finderNames, with a domain or company name10,000
POST/bulk/enrichEmail addresses20,000
POST/bulk/linkedinLinkedIn profile URLs20,000
POST/bulk/authorArticle URLs5,000
POST/bulk/verifierEmail addresses20,000
POST/bulk/phone-finderEmail addresses, LinkedIn URLs or domains10,000
POST/bulk/phone-validatorPhone numbers, with an optional country10,000

Role para o lado para ver todas as colunas

// 03 · limites de requisições

Capacidade por plano

Os limites são por conta, somando todas as suas chaves. Os jobs em massa têm limites próprios.

// limites de requisições

Requisições por segundo / minuto / dia
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 100 / 4,000

Role para o lado para ver todas as colunas

Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Limites de requisições

// 04 · sdks e ferramentas

13 SDKs, uma CLI e um servidor MCP

As bibliotecas oficiais encapsulam os mesmos endpoints; a CLI e o servidor MCP usam sua chave ou OAuth.

// perguntas frequentes

Perguntas Frequentes da API

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. 01Crie uma conta gratuita25 créditos de busca a cada 30 dias. Sem cartão.
  2. 02Copie sua chave e seu secretEm Chaves de API, no painel.
  3. 03Chame a APICole a requisição; a resposta vem em JSON.
Obter chave de API grátisLer a documentação
curl -G https://api.tomba.io/v1/email-finder \
  --data-urlencode "domain=piedpiper.com" \
  --data-urlencode "first_name=Richard" \
  --data-urlencode "last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Resposta
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
      }
    ],
    "phone_data": []
  }
}