Vérifier une liste

Une liste de vérification contrôle de nombreuses adresses d’un coup, par exemple avant d’importer des contacts depuis un autre système ou d’envoyer une campagne à une ancienne liste. Ce guide explique comment créer une liste, suivre sa progression, lire les résultats et les exporter.

Avant de commencer

• Une liste peut contenir jusqu’à 10 000 adresses. Découpez les fichiers plus volumineux en plusieurs listes.
• Chaque adresse unique coûte 5 crédits, débités à la création de la liste. Une liste de 10 000 adresses nécessite 50 000 crédits.
• Les listes utilisent toujours le mode full, qui inclut le contrôle de la boîte aux lettres. Consultez Mode rapide et mode complet.
• Pour l’API, utilisez une clé API Full Access.

Créer une liste

curl https://api.emailit.com/v2/email-verification-lists \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter import October",
    "emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
  }'

{
  "object": "email_verification_list",
  "id": "evl_3Rt8Wq5Lm2Kx",
  "name": "Newsletter import October",
  "status": "processing",
  "stats": {
    "total_emails": 3,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 3
  },
  "created_at": "2026-10-01T11:02:37Z",
  "updated_at": "2026-10-01T11:02:37Z",
  "valid_emails_count": 3,
  "unique_emails_count": 3,
  "invalid_emails_count": 0,
  "dispatched_jobs": 3
}

Avant de débiter les crédits, Emailit nettoie les données saisies : il met chaque adresse en minuscules, supprime les doublons et écarte les entrées sans @. Seules les adresses uniques restantes sont facturées. Si la liste ne peut pas démarrer, les crédits sont remboursés.

Suivre la progression

Le statut de la liste passe par ces étapes :

Dans Email Verification›Lists, la colonne Statistics affiche pour chaque liste les compteurs Total, Pending, Successful et Failed. La colonne Expiring indique le nombre de jours restants avant la suppression de la liste.

Via l’API, appelez Récupérer une liste et lisez status et stats. Pour éviter d’interroger l’API en boucle, abonnez un webhook à email_verification_list.updated, qui se déclenche à la fin de la liste. Chaque adresse déclenche aussi email_verification.updated quand son résultat est prêt.

Examiner les résultats

Sélectionnez une liste dans le tableau de bord pour l’ouvrir. La page affiche :

• des cartes Created, Status, Total Emails, Pending, Successful et Failed ;
• des graphiques Verification Status Progress, Verification Results Breakdown et Risk Levels ;
• un tableau de toutes les adresses avec leur statut, leur résultat, leur risque et leur score.

Via l’API, appelez Lister les résultats. Filtrez par result ou status et parcourez les pages avec page et limit (50 par défaut) :

curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "result=invalid" \
  --data-urlencode "limit=100"

Chaque élément contient les champs id, email, status, result, score, risk et mx_records de l’adresse. Résultats de vérification explique chaque valeur et la marche à suivre.

Exporter les résultats

Une fois la liste completed, vous pouvez télécharger tous ses résultats sous forme de fichier Excel.

curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o results.xlsx

Le fichier contient une ligne par adresse avec son statut, son résultat, son score et son risque, chaque contrôle individuel (syntaxe valide, adresse jetable, adresse générique, boîte pleine, livrable, désactivée, messagerie gratuite, charabia, catch-all, connexion SMTP, enregistrements MX), les parties de l’adresse, l’âge du domaine, la suggestion did_you_mean et les enregistrements MX. Les résultats sont codés par couleur pour une lecture rapide.

Utiliser les résultats

1. Retirez les adresses dont le résultat est invalid, disabled ou disposable avant d’importer ou d’envoyer.
2. Examinez les adresses inbox_full, role et unknown. Conservez-les si vous avez une raison de le faire, mais surveillez leurs rebonds.
3. Importez le reste dans vos contacts ou dans une liste de contacts.

Pour chaque résultat, consultez Actions recommandées.

Voir aussi