API para Email Tools
API para Email Tools: Verificar
Verifique a entregabilidade de um endereço de e-mail: um veredito de status (good, risky ou bad) com sinais de domínio, caixa de correio, catch-all, descartável e endereço de função, além de uma pontuação de confiança. Endereços malformados são rejeitados pelo schema de entrada sem cobrança; todo endereço sintaticamente válido retorna um veredito cobrado, inclusive os que não podem ser entregues.
POST/v1/run/email.verify
Disponibilidade
100,00%
30d · 1.968 chamadas
Requisições
1.968
30d · semanal, últimas 12 sem.
Resposta
5,0s
mediana · 30d
Rede de provedores
Provedores ordenados por tráfego
Teste
Faça sua primeira requisição
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `reason`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um resultado que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
"data": {
"items": [
{
"catchAll": true,
"disposable": true,
"domain": "example.com",
"email": "alex@example.com",
"free": true,
"mxProvider": "a1b2c3d4",
"mxRecords": [
"example"
],
"reason": "example",
"role": true,
"score": 5,
"status": "active"
}
]
},
"found": true,
"reason": "not_found"
}Interface da resposta
interface EmailVerifyResponse {
data: {
items: {
catchAll?: boolean;
disposable?: boolean;
domain?: string;
email: string;
free?: boolean;
mxProvider?: string | null;
mxRecords?: string[];
reason?: string;
role?: boolean;
score?: number;
status: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Requisição, resposta e preço
Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30dPOST /v1/run/email.verify
curl -X POST https://api.getanyapi.com/v1/run/email.verify \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"patrick@stripe.com"}'| Campo | Tipo | Valor de exemplo |
|---|---|---|
| Corpo da requisição | ||
| string | "patrick@stripe.com"O endereço de e-mail a verificar (ex.: jane.doe@acme.com). Exatamente um @, um domínio com ponto, sem espaços em branco nem sinais de menor e maior. Endereços em TLDs reservados que nunca recebem e-mail (.invalid, .test, .example, .localhost, .local, .internal, .blink) e resíduos de escape HTML/JSON (um prefixo u003e) são rejeitados localmente sem cobrança. | |
| requireFields | array | Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `reason`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um resultado que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. |
| Resposta | ||
| data | object | |
| data.items | object[] | Verification records: the email address with its deliverability verdict and the domain, mailbox, and reputation signals behind it. A record is returned for every syntactically valid address, including ones the verdict marks undeliverable. Populated whenever the provider has data for the entity. |
| data.items[].catchAll | boolean | Domain accepts all addresses. |
| data.items[].disposable | boolean | |
| data.items[].domain | string | |
| data.items[].email | string | Populated whenever the provider has data for the entity. |
| data.items[].free | boolean | Free email provider. |
| data.items[].mxProviderpode ser exigido | string | Mail provider behind the address domain, e.g. Google. Null when the serving source does not report one. |
| data.items[].mxRecords | string[] | MX record hosts published by the address domain. |
| data.items[].reasonpode ser exigido | string | Why the verdict was reached. Published by only one of the two sources, so it is absent on most calls; never treat it as required. |
| data.items[].role | boolean | Role-based address (e.g. info@). |
| data.items[].score | integer | Confidence in the verdict, 0-100. Coarse rather than graded on most calls: it tracks the status rather than ranking addresses within one. |
| data.items[].status | string | Deliverability verdict: good (the mailbox accepted), bad (it was refused), or risky (no source could settle it - usually a catch-all domain that accepts every address, sometimes a receiving server that declined to answer at all). Populated whenever the provider has data for the entity. |
| found | boolean | |
| reasonpode ser exigido | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| Preço | ||
| Preço por requisição | USD | US$ 0,0066 |
| Preço /mil req. | USD | US$ 6,60 |
Dúvidas frequentes
Sobre o endpoint Verificar da API para Email Tools
O endpoint Verificar da AnyAPI para Email Tools retorna dados de Email Tools em JSON normalizado com uma chamada POST para /v1/run/email.verify. Verifique a entregabilidade de um endereço de e-mail: um veredito de status (good, risky ou bad) com sinais de domínio, caixa de correio, catch-all, descartável e endereço de função, além de uma pontuação de confiança. Endereços malformados são rejeitados pelo schema de entrada sem cobrança; todo endereço sintaticamente válido retorna um veredito cobrado, inclusive os que não podem ser entregues. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 6,60 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Verificar da API para Email Tools feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 5,0 segundos, em 1.968 chamadas medidas.
Custa a partir de US$ 6,60 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.
Verifique a entregabilidade de um endereço de e-mail: um veredito de status (good, risky ou bad) com sinais de domínio, caixa de correio, catch-all, descartável e endereço de função, além de uma pontuação de confiança. Endereços malformados são rejeitados pelo schema de entrada sem cobrança; todo endereço sintaticamente válido retorna um veredito cobrado, inclusive os que não podem ser entregues. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.
Nos últimos 30 dias, 100,0% das chamadas ao endpoint Verificar da API para Email Tools feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 5,0 segundos, em 1.968 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.