YesWeCheck API
Validation email ultra-précise — Syntaxe, DNS, SMTP multi-pass, détection d'adresses jetables et enrichissement.
Ce que vous pouvez faire
✉️
Validation en temps réel
Validez un email à la volée depuis votre backend ou formulaire. Réponse <300ms pour les checks gratuits.
📂Batch CSV
Uploadez une liste CSV, suivez la progression en temps réel, exportez CSV/XLSX/PDF avec résultats détaillés.
🔑Clés API
Authentification simple par API Key. Configurez les features activées et les domaines autorisés par clé.
⚡Codes erreur et Limits
Codes HTTP, rate limits, gestion des crédits insuffisants et stratégies de retry.
Les vérifications disponibles
| Check | Vitesse | Crédits |
|---|---|---|
| ✅ Syntaxe (RFC 5322, normalisation) | ~1ms | Gratuit |
| ✅ DNS / MX Records | ~50ms | Gratuit |
| ✅ Détection jetable (10min mail, etc.) | ~5ms | Gratuit |
| ✅ Role account (info@, admin@, support@) | ~1ms | Gratuit |
| ✅ Typo domain (gmial.com → gmail.com) | ~5ms | Gratuit |
| ✅ Random detection (x7k3p9@...) | ~5ms | Gratuit |
| 💳 SMTP (vérification boîte réelle) | 1–15s | 1 crédit |
| 💳 Enrichissement (prénom probable) | ~10ms | Inclus SMTP |
Démarrage rapide
curl -X POST https://api.yeswecheck.fr/v2/email/validate \
-H "Authorization: Bearer ywc_live_votre_cle" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'
{
"email": "[email protected]",
"status": "risky",
"score": 60,
"roleAccount": { "isRoleAccount": true, "reason": "Generic prefix: contact" },
"disposable": { "isDisposable": false },
"metadata": { "creditsUsed": 0, "processingTimeMs": 187 }
}
Obtenir une clé API
Créez votre clé depuis le Dashboard → Settings → API Keys.
Statuts de réponse
| Statut | Signification | Action recommandée |
|---|---|---|
valid | Email valide et délivrable | ✅ Accepter |
invalid | Email invalide — définitif | ❌ Refuser |
risky | Risqué (jetable, role, aléatoire) | ⚠️ Filtrer selon contexte |
unknown | Vérification impossible (timeout SMTP) | 🟡 Accepter avec prudence |
Liens utiles
| 🎛️ Dashboard | app.yeswecheck.fr |
| 🟢 Statut API | status.yeswecheck.fr |
| 📧 Support | [email protected] |