Une API de vérification d’email qui résout aussi les adresses catch-all
Vérifiez si une boîte mail existe avec un seul appel REST. Sur les domaines catch-all, la plupart des API s’arrêtent à « accept-all » ou « risqué ». Ici, vous obtenez un résultat valide ou invalide dans la même réponse. Notre API de vérification d’email donne aux équipes techniques des données JSON propres. Elles protègent ainsi leur réputation d’expéditeur dans leurs flux de prospection.
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édits gratuits, aucune carte requise. Les crédits n’expirent jamais.
Giggal.ai est classé Leader sur SourceForge et Slashdot
Ce que renvoie un appel à l’API
Un seul appel renvoie toutes les données de délivrabilité. Vous recevez le statut de délivrabilité principal, l’évaluation du risque, un score de délivrabilité chiffré, les attributs de la boîte mail et le résultat catch-all dans la même réponse.
{
"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
}
}Comment traiter les valeurs de statut
Le statut de délivrabilité principal est renvoyé dans le champ status. Voici comment votre application backend doit lire et traiter chaque valeur :
| Statut | Signification | Action recommandée |
|---|---|---|
| deliverable | Le serveur de messagerie de destination a accepté le destinataire. La boîte mail est active. | Envoi sans risque. À inclure dans vos campagnes principales. |
| undeliverable | La boîte mail n’existe pas, la syntaxe est invalide, le domaine n’a pas d’enregistrement MX ou le domaine est jetable. | Ne pas envoyer. Retirez l’adresse des campagnes pour éviter les hard bounces. |
| unknown | La réponse du serveur n’est pas concluante, en général à cause du greylisting ou d’un délai de connexion dépassé. | Relancez la vérification plus tard. Les crédits des réponses inconnues sont remboursés automatiquement. |
Adresses catch-all résolues dans le même appel
Les contrôles standard échouent sur les domaines catch-all. Quand le serveur de messagerie d’une entreprise accepte toutes les adresses, les outils standard reçoivent une réponse positive pour les vraies boîtes mail comme pour les fautes de frappe. Faute de pouvoir aller plus loin, la plupart des outils marquent l’adresse comme « risquée » ou « accept-all » et vous laissent décider.
Environ 30 % d’une liste B2B typique se trouve sur des domaines catch-all ou derrière des passerelles de messagerie sécurisées (SEG) comme Proofpoint et Mimecast. Supprimer ces adresses fait perdre de vrais acheteurs. Leur écrire sans vérification fait grimper les rebonds.
Notre moteur de vérification résout les adresses catch-all en détail dans le même appel. Il vérifie si la boîte mail existe et renvoie un catch_all_verdict (« valid » ou « invalid ») et un catch_all_score de 0 à 100. Pour en savoir plus, lisez nos guides sur la vérification catch-all et sur la vérification des boîtes mail derrière les passerelles de messagerie sécurisées.
API de vérification classique
Abandonne sur les domaines accept-all
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}Le doute revient à votre équipe. Vous envoyez et risquez beaucoup de rebonds, ou vous écartez de vrais acheteurs potentiels.
API Giggal.ai
Résout les catch-all dans le même appel
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}Boîte mail active confirmée. Vous gardez vos vrais contacts catch-all et protégez votre réputation d’expéditeur.
Endpoints pour les vérifications unitaires, en masse et catch-all
Que vous vérifiiez un seul contact ou de grandes listes, notre API propose des endpoints dédiés, conçus pour la rapidité et la fiabilité.
Vérification d’un email
Vérification synchrone d’une seule adresse mail. Elle contrôle si l’adresse existe, analyse le domaine et résout les adresses catch-all dans le même appel. Elle renvoie un résultat JSON complet.
Voir la documentation de l’endpointVérification d’emails en masse
Traitement asynchrone de 50 000 adresses au maximum par tâche. Les doublons et les syntaxes invalides sont retirés côté serveur. L’en-tête Idempotency-Key évite les doubles facturations.
Suivi des tâches et résultats
Suivez l’avancement d’une tâche avec GET /v1/jobs/:jobId toutes les 10 à 15 secondes. Récupérez les résultats paginés, jusqu’à 500 lignes par page. Les résultats sont conservés 48 heures.
Résolution catch-all en masse
Lancez la résolution catch-all approfondie sur les adresses marquées catch-all dans une tâche en masse terminée. Téléchargez les résultats dans un fichier CSV propre, avec des colonnes de score et de statut.
Voir la documentation catch-allLes indicateurs de chaque réponse
Au-delà de valide ou invalide, chaque réponse contient les attributs détaillés de la boîte mail. Ils vous aident à segmenter vos contacts, à prévenir les abus et à appliquer des règles de filtrage automatiques.
| Indicateur | Chemin du champ | Description et usage |
|---|---|---|
| Jetable | details.attributes.disposable | Repère les boîtes temporaires et jetables. Bloquez-les tout de suite pour stopper les abus d’essai gratuit. |
| Adresse générique | details.attributes.role_account | Détecte les boîtes génériques de service (info@, billing@, support@). Dirigez-les vers les équipes CRM. |
| Messagerie gratuite | details.attributes.free_email | Signale les domaines de messagerie grand public (gmail.com, yahoo.com) pour séparer les boîtes personnelles des prospects d’entreprise. |
| Catch-all | details.attributes.catch_all | Indique si le serveur accepte tout le courrier. Utilisez-le avec catch_all_verdict pour récupérer les contacts valides. |
| Alias avec signe plus | details.attributes.has_plus_tag | Détecte les adresses avec sous-adressage (user+tag@). Empêche la création de comptes multiples. |
| Boîte pleine | details.attributes.mailbox_full | Indique que le quota de stockage est dépassé. Un email envoyé à cette adresse provoquera un soft bounce. |
| No-reply | details.attributes.no_reply | Signale les adresses d’envoi que personne ne lit. N’y envoyez pas de messages de prospection. |
| Contrôle de liste noire | details.blacklist.is_blacklisted | Contrôle le domaine et les IP du serveur sur les principales listes DNSBL, avec des scores de réputation. |
Où les équipes utilisent l’API de vérification d’email
Nos endpoints se connectent directement aux flux de données, aux workflows CRM et aux bases de données.
Synchronisation CRM et entrepôt de données
Vérifiez les données de contact en continu avant de les synchroniser vers Salesforce, HubSpot ou Snowflake. Nettoyez les fiches obsolètes à intervalles réguliers et gardez des données de contact exactes.
Nettoyage de liste avant une campagne
Nettoyez vos listes email avant les grands envois de prospection. Vous pouvez aussi importer vos listes directement dans notre interface de nettoyage de liste email pour un traitement manuel rapide.
Flux d’enrichissement de leads
Lancez une vérification automatique de la boîte mail dès que vos SDR ou vos outils d’enrichissement trouvent de nouveaux emails d’entreprise. Vos commerciaux ne contactent ainsi que des adresses vérifiées.
Automatisation des workflows
Connectez nos endpoints de vérification à Zapier, n8n, Make et à vos workflows de webhooks via notre page intégrations.
Agents IA via MCP
Permettez à Claude, ChatGPT, Cursor et à vos agents IA de vérifier des contacts pendant les conversations grâce à notre serveur MCP.
Validation des formulaires d’inscription
Vous voulez contrôler les adresses au moment où les utilisateurs les saisissent dans vos formulaires d’inscription et de capture de leads ? Découvrez notre API de validation d’email, conçue pour les contrôles de formulaire en temps réel.
Exemples de code
Extraits côté serveur pour les vérifications unitaires et en masse. Gardez votre clé API dans des variables d’environnement.
// 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"))Flux en masse : envoyer, suivre et récupérer les résultats
Une tâche en masse s’envoie en un seul appel. Interrogez son statut toutes les 10 à 15 secondes jusqu’à ce qu’il passe à 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();Tarifs de l’API de vérification d’email
Un tarif simple à l’usage, sans engagement mensuel. Un crédit vérifie une adresse. Pour les appels unitaires, la résolution catch-all est comprise dans ce même crédit. Pour les tâches en masse, la vérification standard coûte 1 crédit par adresse, et la vérification approfondie des lignes catch-all coûte 1 crédit par adresse catch-all vérifiée. Les crédits n’expirent jamais, et les résultats inconnus sont remboursés automatiquement.
Besoin d’un volume plus important ? Consultez tous nos paliers de prix.
Limites de débit et erreurs
Des limites de débit standard s’appliquent à chaque clé API. L’état de ces limites est renvoyé dans chaque réponse par deux en-têtes standard :X-RateLimit-Limit etX-RateLimit-Remaining.
Limites de débit par fenêtre de 15 minutes
- Vérifications unitaires (/v1/verify)300 requêtes / 15 min
- Création de tâches en masse30 requêtes / 15 min
- Création de tâches catch-all30 requêtes / 15 min
- Suivi des tâches et résultats600 requêtes / 15 min
Codes d’erreur HTTP
- 400 Bad Request: Syntaxe invalide ou corps JSON mal formé.
- 401 Unauthorized: Clé API absente, expirée ou invalide.
- 402 Payment Required: Solde de crédits insuffisant.
- 404 Not Found: L’identifiant de tâche demandé n’existe pas.
- 409 Conflict: Conflit sur la clé d’idempotence.
- 410 Gone: Les résultats de la tâche ont expiré après 48 heures.
- 429 Too Many Requests: Limite de débit dépassée.
Le format détaillé des réponses d’erreur et la description de leur contenu se trouvent dans la documentation des erreurs de l’API.
Ce qu’en disent nos clients
Les avis réels d’équipes techniques, commerciales et marketing qui utilisent 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.
Utilisateur vérifié sur 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.
Utilisateur sur 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
Utilisateur sur Product Hunt
FAQ sur l’API de vérification d’email
Les questions techniques fréquentes sur l’authentification, la vérification des boîtes mail et les adresses catch-all.
Oui. Chaque nouveau compte reçoit 1 000 crédits gratuits dès l’inscription, sans carte bancaire. Vous pouvez créer une clé API dans votre tableau de bord et envoyer vos premières requêtes tout de suite. Les crédits gratuits n’expirent jamais et donnent accès à tous les endpoints, y compris la vérification complète des boîtes mail et la résolution catch-all approfondie.
L’API vérifie si la boîte mail existe. Elle fait des requêtes DNS et MX, se connecte au serveur de messagerie de destination et contrôle si la boîte mail précise existe et peut recevoir du courrier. La connexion est fermée proprement avant l’envoi de tout message. Votre destinataire ne reçoit donc aucun email.
Sur les domaines catch-all, un serveur de messagerie standard indique que toutes les adresses sont acceptées. Les outils ordinaires renvoient alors « risqué » ou « inconnu ». Giggal vérifie si la boîte mail existe et renvoie un résultat valide ou invalide avec un catch_all_score de 0 à 100. Vous évitez ainsi de supprimer de vrais contacts.
Le statut « inconnu » apparaît quand le serveur de messagerie de destination ne donne pas de réponse claire dans notre délai, en général à cause d’un greylisting strict ou d’une panne temporaire du serveur. Les réponses non concluantes ne sont jamais facturées : les crédits de toute vérification qui renvoie le statut inconnu sont remboursés automatiquement sur votre solde.
Une requête unitaire vérifie un email de façon synchrone et renvoie directement une réponse JSON. Pour les listes, notre endpoint en masse accepte jusqu’à 50 000 adresses par tâche, de façon asynchrone. Vous suivez l’avancement de la tâche et récupérez les résultats paginés à la fin du traitement.
Oui. Giggal.ai héberge un serveur MCP (Model Context Protocol) distant officiel à l’adresse https://mcp.giggal.ai/mcp. Claude et ChatGPT se connectent au serveur hébergé via OAuth, sans clé API. Pour un usage local dans Cursor, VS Code et d’autres clients, vous pouvez configurer le serveur local giggal-mcp avec votre clé API et vérifier des adresses depuis votre éditeur.
Une API de vérification d’email contrôle si une boîte mail existe vraiment. Elle échange directement avec les serveurs de messagerie de destination, vérifie les enregistrements DNS et résout les adresses catch-all dans les listes commerciales et les bases clients. Une API de validation d’email sert surtout aux contrôles en temps réel dans les formulaires d’inscription. Elle vérifie le format, repère les domaines jetables et bloque les faux comptes à l’envoi du formulaire. Pour protéger vos formulaires, découvrez notre API de validation d’email.
Regardez trois points : une vraie résolution des catch-all, pour ne pas perdre jusqu’à 30 % de vos contacts B2B dans la catégorie « risqué » ; une facturation transparente qui rembourse automatiquement les résultats inconnus ; un prix clair par vérification, sans frais récurrents cachés ni minimum mensuel.
Commencez à vérifier des emails en quelques minutes
1 000 crédits offerts, sans carte bancaire.
