API de consulta de e-mail
O endpoint de e-mail valida o formato e retorna os dados cadastrais vinculados ao endereço, quando disponíveis. É usado para antifraude, deduplicação de base e higienização de cadastros — confirmando se um e-mail corresponde a um titular conhecido.
Para que serve
- Antifraude: verificar se o e-mail informado bate com o titular esperado.
- Higienização e deduplicação de base de cadastros.
- Enriquecimento de contato em processos autorizados.
Requisição
Autentique com o header Authorization: Bearer — gere seu token no dashboard após ativar um plano.
curl -X POST "https://apiconsultas.xyz/api/v1/consultas/email" \
-H "Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"titular@exemplo.com"}'const res = await fetch("https://apiconsultas.xyz/api/v1/consultas/email", {
method: "POST",
headers: {
Authorization: "Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({"email":"titular@exemplo.com"}),
});
const data = await res.json();<?php
$ch = curl_init("https://apiconsultas.xyz/api/v1/consultas/email");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxx",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => '{"email":"titular@exemplo.com"}',
]);
$data = json_decode(curl_exec($ch), true);Resposta (200)
Exemplo com valores ilustrativos. O nível de detalhe (dados completos ou mascarados) depende do seu plano.
{
"success": true,
"tipo_consulta": "email",
"query": {
"termo_mascarado": "ti***@exemplo.com",
"finalidade": "antifraude"
},
"resultado_count": 1,
"data_quality": {
"sources_used": 1,
"confidence_score": 80,
"has_contacts": true
},
"data": [
{
"identificacao": {
"nome": "NOME DO TITULAR"
},
"contato": {
"emails": [
"titular@exemplo.com"
],
"telefones": [
"(11) 9****-**21"
]
}
}
],
"audit": {
"logged": true,
"timestamp": "2026-07-01T12:00:00.000Z"
},
"message": "Consulta realizada com sucesso."
}Campos retornados
| Campo | Descrição |
|---|---|
| identificacao.nome | Titular vinculado ao e-mail, quando disponível. |
| contato.emails | E-mails vinculados (mascarados conforme plano). |
| contato.telefones | Telefones vinculados, quando disponíveis. |
| data_quality | sources_used e confidence_score do resultado. |
Perguntas frequentes
O e-mail é validado?
Sim. Endereços com formato inválido retornam erro 400 antes de consumir a consulta.
O que retorna se o e-mail não estiver na base?
Uma resposta com resultado_count 0 e a mensagem de nenhum registro encontrado — você não paga por dado inexistente.
Isso serve para enviar campanhas?
Não. O endpoint é para verificação e antifraude sob finalidade legítima e auditada, não para prospecção ou disparo de mensagens.
Endpoints relacionados
Integre consulta de e-mail hoje
Ative um plano a partir de R$ 10, gere seu token Bearer e comece a consultar em minutos. Consultas ilimitadas enquanto o plano estiver ativo.