Que padroes de email sao detetados?

Padroes comuns incluem: primeiro.ultimo@, p.ultimo@, primeiro@, ultimo.primeiro@, primeiro_ultimo@ e outros. Todas as variantes detetadas sao retornadas com a sua percentagem de utilizacao.

Quao precisa e a detecao de padroes?

Os padroes sao calculados a partir de enderecos de email verificados na nossa base de dados. A percentagem reflete a distribuicao real entre os contactos conhecidos no dominio.

Uma empresa pode ter multiplos padroes?

Sim. Muitas empresas usam mais de um formato de email. A API retorna todos os padroes detetados classificados por frequencia.

Quantos creditos por requisicao?

1 credito por requisicao de formato de email.

Como posso usar estes dados?

Use o padrao dominante para gerar enderecos de email para prospetos, validar enderecos estimados ou enriquecer os dados do seu CRM com formatos previstos.

Que SDKs estao disponiveis?

13 SDKs oficiais: Python, Node.js, PHP, Ruby, Go, Dart, Lua, R e Elixir.

// get /v1/email-format

Email Format API

Detete os padroes de formato de email usados por qualquer dominio de empresa. Retorna todos os padroes detetados com a sua distribuicao percentual para que possa prever enderecos de funcionarios.

Obter chave de API grátis Referência da API

1 email count credit

// console da api

Exemplo de resposta da referência da API

[0].format: {first}
[0].percentage: 66

// 01 · requisição

Email Format é uma requisição HTTPS

Envie os parâmetros com sua chave e seu secret. Todos os SDKs, a CLI e o servidor MCP fazem esta mesma chamada.

GET/email-formatParâmetro

domainobrigatório: Company domain

GET /email-format

curl "https://api.tomba.io/v1/email-format?domain=piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const res = await fetch("https://api.tomba.io/v1/email-format?domain=piedpiper.com", {
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
  }
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.tomba.io/v1/email-format?domain=piedpiper.com",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// 02 · resposta

O que volta

JSON, igual em todas as linguagens. Campos que a Tomba não conhece vêm como null, nunca adivinhados.

GET/email-formatCampo

data[].formatstring: Pattern such as {first}.{last}
data[].percentageinteger: Share of the company's addresses

GET /email-format

200 OK· 1 email count credit

{
  "data": [
    {
      "format": "{first}",
      "percentage": 66
    },
    {
      "format": "{first}.{last}",
      "percentage": 34
    }
  ]
}

// 03 · custo e limites

Quanto custa uma chamada

Uma chamada só é cobrada na condição abaixo. Os limites de requisições dependem do seu plano.

// custo

1email count credit

Cobrado quando: Every successful call, including an empty result.

Erros, respostas 429 e 451, e a mesma requisição repetida dentro da sua janela de uso não custam nada.

Como os créditos funcionam

// limites de requisições

Requisições por segundo / minuto / dia

	Free	Basic	Growth	Pro
Search, finder, similar, technology	1 / 2 / 5	3 / 50 / 500	5 / 80 / 1,000	8 / 150 / 4,000
Email verifier	1 / 2 / 10	2 / 40 / 500	3 / 60 / 1,000	5 / 100 / 4,000

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

// faq

Perguntas sobre a API de Formato de Email

Ainda tem dúvidas? Visite a central de ajuda

Faça sua primeira chamada em um minuto

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

1Crie uma conta gratuita25 buscas por mês. Sem cartão.

2Copie sua chave e seu secretEm Chaves de API, no painel.

3Chame a APICole a requisição; a resposta vem em JSON.

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY } }); const { data } = await res.json();

import os, requests res = requests.get( "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", headers={ "X-Tomba-Key": os.environ["TOMBA_API_KEY"], "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"], }, ) data = res.json()["data"]

{ "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": [] } }