API de verificação de e-mail que também resolve os endereços catch-all
Verifique se qualquer caixa existe com uma única chamada REST. Em domínios catch-all, onde a maioria das APIs para em "accept-all" ou "arriscado", você recebe um resultado válido ou inválido na mesma resposta. Nossa API de verificação de e-mail entrega aos times de engenharia dados JSON limpos para proteger a reputação de remetente em todos os fluxos de prospecção.
curl -X POST https://api.giggal.ai/v1/verify \
-H "Authorization: Bearer tp_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"alex.smith@example.com"}'1.000 créditos grátis, sem cartão. Os créditos nunca expiram.
A Giggal.ai é avaliada como Líder no SourceForge e no Slashdot
O que uma chamada à API devolve
Uma única chamada devolve todos os dados de entregabilidade. Você recebe o status principal de entregabilidade, a avaliação de risco, uma pontuação numérica de entregabilidade, os atributos da caixa e os resultados de catch-all na mesma resposta.
{
"success": true,
"data": {
"email": "alex.smith@example.com",
"is_valid": true,
"status": "deliverable",
"risk_level": "low",
"deliverability_score": 92,
"catch_all_score": 89,
"catch_all_verdict": "valid",
"details": {
"general": {
"domain": "example.com",
"reason": "Mailbox confirmed deliverable"
},
"attributes": {
"free_email": false,
"role_account": false,
"disposable": false,
"catch_all": true,
"has_plus_tag": false,
"mailbox_full": false,
"no_reply": false
},
"mail_server": {
"smtp_provider": "google",
"mx_record": "aspmx.l.google.com"
}
}
},
"meta": {
"creditsUsed": 1
}
}Como tratar os valores de status da resposta
O status principal de entrega vem no campo status. Veja como a sua aplicação backend deve interpretar e encaminhar cada valor:
| Status | Significado | Ação recomendada |
|---|---|---|
| deliverable | O servidor de e-mail de destino aceitou o destinatário na conexão. A caixa está ativa. | Pode enviar. Inclua nas campanhas principais de prospecção. |
| undeliverable | A caixa não existe, a sintaxe é inválida, o domínio não tem registros MX ou o domínio é descartável. | Não envie. Remova das campanhas para evitar hard bounces. |
| unknown | Resposta inconclusiva do servidor, normalmente por greylisting ou por tempo de conexão esgotado. | Verifique de novo mais tarde. Os créditos das respostas desconhecidas são reembolsados automaticamente. |
Endereços catch-all resolvidos na mesma chamada
As verificações comuns falham em domínios catch-all. Quando o servidor de e-mail de uma empresa aceita qualquer endereço recebido, as ferramentas comuns veem uma resposta positiva tanto para caixas reais quanto para erros de digitação. Sem conseguir verificar mais, a maioria marca o endereço como "arriscado" ou "accept-all" e deixa a decisão com você.
Cerca de 30 % de uma lista B2B típica fica em domínios catch-all ou em domínios atrás de gateways de segurança (SEGs) como Proofpoint e Mimecast. Apagar esses endereços descarta compradores reais. Enviar sem verificar causa picos de bounce.
Nosso motor de verificação faz a resolução completa de catch-all na mesma chamada. Ele verifica se a caixa existe para devolver catch_all_verdict ("valid" ou "invalid") e catch_all_score de 0 a 100. Saiba mais nos nossos guias sobre verificação catch-all e sobre como verificar caixas atrás de gateways de segurança.
API de verificação tradicional
Desiste dos domínios accept-all
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}A dúvida fica com o seu time. Você envia e arrisca muitos bounces, ou descarta compradores em potencial válidos.
API da Giggal.ai
Resolve catch-all na mesma chamada
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}Caixa ativa confirmada. Mantenha seus leads catch-all reais e proteja sua reputação de remetente.
Endpoints para verificações individuais, em massa e catch-all
Para verificar um único contato ou listas grandes, nossa API para verificar e-mails tem endpoints feitos para desempenho e confiabilidade.
Verificação de um e-mail
Verificação síncrona de um único endereço de e-mail. Confere se o endereço existe, faz o diagnóstico do domínio e resolve endereços catch-all na mesma chamada. Devolve um resultado JSON completo.
Ver a documentação do endpointVerificação de e-mail em massa
Processamento assíncrono de até 50.000 endereços por job. Remove duplicados e sintaxe inválida no servidor. Aceita o cabeçalho Idempotency-Key para evitar cobrança em dobro.
Consulta do job e resultados
Consulte o progresso do job com GET /v1/jobs/:jobId a cada 10 a 15 segundos. Obtenha resultados paginados com até 500 registros por página. Os resultados ficam guardados com segurança por 48 horas.
Resolução de catch-all em massa
Faça a resolução completa de catch-all nos endereços marcados como catch-all em um job em massa concluído. Baixe os resultados em um CSV limpo com colunas de pontuação e status.
Ver a documentação de catch-allIndicadores em todas as respostas
Além de válido ou inválido, toda resposta traz atributos detalhados da caixa para você segmentar leads, evitar abusos e aplicar regras de filtragem automáticas.
| Indicador | Caminho do campo | Descrição e uso |
|---|---|---|
| Descartável | details.attributes.disposable | Identifica caixas temporárias descartáveis. Bloqueie na hora para impedir fraude em testes grátis. |
| Conta de função | details.attributes.role_account | Detecta caixas genéricas de departamento (info@, billing@, support@). Encaminhe para os times de CRM. |
| E-mail gratuito | details.attributes.free_email | Marca domínios de webmail pessoal (gmail.com, yahoo.com) para separar caixas pessoais de leads corporativos. |
| Catch-all | details.attributes.catch_all | Indica se o servidor aceita todas as mensagens. Use com catch_all_verdict para recuperar leads válidos. |
| Alias com sinal de mais | details.attributes.has_plus_tag | Detecta endereços com subendereçamento de alias (user+tag@). Evita que uma mesma pessoa crie várias contas. |
| Caixa cheia | details.attributes.mailbox_full | Indica que a cota de armazenamento foi excedida. Mensagens enviadas para esse endereço vão dar soft bounce. |
| No-reply | details.attributes.no_reply | Marca endereços de envio em massa que ninguém acompanha. Evite enviar para esses endereços mensagens de prospecção que esperam resposta. |
| Verificação de blacklist | details.blacklist.is_blacklisted | Avalia o domínio e os IPs do servidor nas principais listas DNSBL, com pontuações de reputação. |
Onde os times usam a API de verificação de e-mail
Nossos endpoints se conectam diretamente a pipelines de dados, fluxos de CRM e bancos de dados.
Sincronização com CRM e data warehouse
Verifique os dados de contato continuamente antes de sincronizar com Salesforce, HubSpot ou Snowflake. Limpe registros antigos de forma programada e mantenha os dados de contato corretos.
Limpeza de listas para campanhas
Limpe as listas de e-mail antes de grandes disparos de prospecção. Você também pode enviar listas direto pela nossa interface de limpeza de lista de e-mail para um trabalho manual rápido.
Pipelines de enriquecimento de leads
Dispare verificações automáticas de caixa sempre que suas ferramentas de SDR inbound ou de enriquecimento outbound encontrarem novos e-mails corporativos, para que os vendedores só contatem endereços verificados.
Automação de fluxos de trabalho
Conecte nossos endpoints de verificação diretamente a fluxos do Zapier, n8n, Make e webhooks pela nossa central de integrações.
Agentes de IA via MCP
Permita que Claude, ChatGPT, Cursor e seus próprios agentes de IA verifiquem contatos durante as conversas com o nosso servidor MCP.
Validação de formulários de cadastro
Quer verificar endereços enquanto os usuários digitam em formulários de cadastro e de captura de leads? Conheça nossa API de validação de e-mail, feita para verificações em tempo real em formulários.
Exemplos de código
Trechos para o servidor, para verificações individuais e em massa. Guarde sua chave de API em variáveis de ambiente.
// Node.js (Node 18+)
const res = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: 'alex.smith@example.com' }),
});
const data = await res.json();
if (data.success) {
console.log('Status:', data.data.status); // deliverable, undeliverable, unknown
console.log('Catch-all result:', data.data.catch_all_verdict); // valid | invalid
} else {
console.error('Verification error:', data.error);
}import os
import requests
url = "https://api.giggal.ai/v1/verify"
headers = {
"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}",
"Content-Type": "application/json"
}
payload = {"email": "alex.smith@example.com"}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
if result.get("success"):
data = result["data"]
print("Status:", data["status"])
print("Catch-All Result:", data.get("catch_all_verdict"))
else:
print("Error:", result.get("error"))Fluxo em massa: enviar, consultar e buscar resultados
Enviar um job em lote exige uma única chamada. Consulte a cada 10 a 15 segundos até o status do job chegar a completed.
// 1. Submit batch job (up to 50,000 emails)
const submitRes = await fetch('https://api.giggal.ai/v1/verify-batch', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'batch-job-2026-10-01-01',
},
body: JSON.stringify({
name: 'Q4 Sales Leads',
emails: ['alex.smith@example.com', 'maria.garcia@example.org'],
}),
});
const { data: job } = await submitRes.json();
const jobId = job.jobId;
// 2. Poll job status until completed
// GET https://api.giggal.ai/v1/jobs/${jobId}
// 3. Fetch paginated verification results
const resultsRes = await fetch(`https://api.giggal.ai/v1/jobs/${jobId}/results?page=1&limit=500`, {
headers: { 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}` },
});
const results = await resultsRes.json();Preços da API de verificação de e-mail
Preço simples, pago conforme o uso, sem fidelidade mensal. Um crédito verifica um endereço. Nas verificações individuais pela API, a resolução de catch-all está incluída no mesmo crédito. Nos jobs em lote, a verificação padrão custa 1 crédito por endereço, e a verificação completa das linhas catch-all custa 1 crédito por endereço catch-all verificado. Os créditos nunca expiram, e os resultados desconhecidos são reembolsados automaticamente.
Precisa de um volume maior para a sua empresa? Veja todas as nossas faixas de preço.
Limites de requisição e erros
Limites padrão de requisição valem por chave de API. O status do limite volta em todas as requisições por cabeçalhos padrão:X-RateLimit-Limit eX-RateLimit-Remaining.
Limites por janela de 15 minutos
- Verificações individuais (/v1/verify)300 requisições / 15 min
- Criação de jobs em lote30 requisições / 15 min
- Criação de jobs de catch-all30 requisições / 15 min
- Consulta de jobs e resultados600 requisições / 15 min
Códigos de erro de status HTTP
- 400 Bad Request: Sintaxe inválida ou corpo JSON malformado.
- 401 Unauthorized: Chave de API ausente, expirada ou inválida.
- 402 Payment Required: Saldo de créditos insuficiente na conta.
- 404 Not Found: O ID de job solicitado não existe.
- 409 Conflict: Conflito de chave de idempotência.
- 410 Gone: Os resultados do job em lote expiraram após 48 horas.
- 429 Too Many Requests: Limite de requisições excedido.
Os formatos detalhados das respostas de erro e suas descrições estão na documentação de erros da API.
O que os clientes dizem
Opiniões reais de times de engenharia, vendas e growth que usam a Giggal.ai.
"Before Giggal, our team spent hours manually reviewing catch-all addresses because other tools couldn't verify them with confidence. Now we upload large email lists, verify them in minutes, and move directly into campaign preparation."
Vernon L.
Avaliação verificada no G2
"Fast and accurate email verification, excellent catch-all detection, easy-to-use interface, quick processing for large lists, lower bounce rates, improved sender reputation, and more confidence before launching email campaigns."
Billy W.
Avaliação no SourceForge
"Giggal Email Verifier makes email validation fast, simple, and reliable. It helps us clean our lists, reduce bounce rates, and improve the overall performance of our outreach campaigns. The accuracy of the verification results makes it a valuable tool."
Hazel Peterson
Avaliação no Product Hunt
Perguntas frequentes sobre a API de verificação de e-mail
Dúvidas técnicas comuns sobre autenticação, verificação de caixas e tratamento de catch-all.
Sim. Cada conta nova recebe 1.000 créditos grátis logo no cadastro, sem cartão de crédito. Você pode gerar uma chave de API no seu painel de desenvolvedor e começar a enviar requisições de verificação na hora. Os créditos grátis nunca expiram e dão acesso completo a todos os endpoints, incluindo a verificação completa da caixa e a resolução completa de catch-all.
A API verifica se a caixa existe. Ela faz consultas DNS e MX, se conecta ao servidor de e-mail de destino e confere se aquela caixa existe e pode receber mensagens. A conexão é encerrada de forma limpa antes de qualquer mensagem ser transmitida, então o destinatário nunca recebe um e-mail.
Em domínios catch-all, um servidor de e-mail comum informa que qualquer endereço é aceito, o que faz as ferramentas comuns devolverem "arriscado" ou "desconhecido". A Giggal verifica se a caixa existe e devolve um resultado válido ou inválido com um catch_all_score de 0 a 100, para você não descartar leads reais.
O status "desconhecido" aparece quando o servidor de e-mail de destino não dá uma resposta clara dentro do nosso tempo limite, normalmente por greylisting agressivo ou por falhas temporárias do servidor. Você nunca paga por respostas inconclusivas: os créditos de qualquer verificação com status desconhecido voltam automaticamente para o saldo da sua conta.
As requisições de verificação individual conferem um e-mail por chamada, de forma síncrona, com uma resposta JSON direta. Para verificar listas, nosso endpoint em massa aceita até 50.000 endereços de e-mail por job, de forma assíncrona. Você acompanha o progresso consultando o job e busca os resultados paginados quando o processamento termina.
Sim. A Giggal.ai hospeda um servidor MCP (Model Context Protocol) remoto oficial em https://mcp.giggal.ai/mcp. Claude e ChatGPT se conectam ao servidor hospedado por OAuth, sem chave de API. Para fluxos de desenvolvimento locais no Cursor, no VS Code e em outros clientes, você pode configurar o servidor local giggal-mcp com sua chave de API e verificar endereços direto do seu editor.
Uma API de verificação de e-mail confere se uma caixa realmente existe: ela fala direto com os servidores de e-mail de destino, verifica os registros DNS e resolve endereços catch-all em listas de vendas e bases de clientes. Uma API de validação de e-mail foca em verificações em tempo real nos formulários de cadastro: confere o formato, identifica domínios descartáveis e bloqueia contas falsas no envio do formulário. Se você precisa proteger formulários, conheça nossa API de validação de e-mail.
Procure três fatores: resolução real de catch-all, para não perder até 30 % dos seus contatos B2B no grupo dos "arriscados"; regras de cobrança claras, com reembolso automático dos resultados desconhecidos; e preço claro por verificação, sem taxas recorrentes escondidas nem mínimos mensais.
Comece a verificar e-mails em minutos
1.000 créditos grátis, sem cartão.
