Docs/Vérification en masse

Vérification en masse

Importez un CSV d'adresses e-mail et obtenez les résultats pour toute votre liste.

Voir le Markdown OpenAPI JSON

Vue d'ensemble

La vérification en masse vous permet de vérifier des milliers d'adresses e-mail en un seul traitement. Importez un fichier CSV depuis le tableau de bord ou via l'API, puis téléchargez les résultats une fois le traitement terminé.

ℹ️
La vérification en masse est disponible depuis le tableau de bord et via l'API. Importez vos fichiers CSV avec POST /api/bulk, interrogez GET /api/bulk/{job_id}, puis téléchargez les résultats depuis /api/bulk/{job_id}/download.

Import via l'API

Envoyez un import CSV multipart avec votre clé API. Vous pouvez éventuellement transmettre email_column lorsque le champ e-mail ne s'appelle pas email.

bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

Import depuis le tableau de bord

  1. Connectez-vous à verimails.com/dashboard
  2. Cliquez sur Bulk Verify dans la barre latérale
  3. Importez votre fichier CSV
  4. Attendez la fin du traitement (visible dans votre liste de traitements)
  5. Téléchargez le CSV de résultats

Format CSV

Votre CSV doit comporter une colonne d'adresses e-mail. VeriMails détecte automatiquement les en-têtes courants comme email, Email Address, work_email, et business_email. Les CSV à une seule colonne sans en-tête sont aussi pris en charge, mais un en-tête e-mail explicite reste préférable :

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

Les colonnes supplémentaires sont conservées dans le fichier de sortie et n'affectent pas le traitement.

Formats pris en charge

Format de sortie

Le fichier de résultats complet conserve les colonnes du CSV d'origine et ajoute une colonne explicite indiquant si l'envoi est possible :

Colonne ajoutéeDescription
Safe to SendYes lorsque le statut vérifié est valide ; No pour les résultats invalides, catch-all, jetables, inconnus ou à risque.

Suivre le statut d'un traitement

Dans le tableau de bord, votre liste de traitements affiche la progression en temps réel. Via l'API, interrogez GET /api/bulk/{job_id} jusqu'à ce que le statut du traitement soit completed ou failed.

Notifications par webhook

La prise en charge des webhooks pour la fin des traitements en masse arrive bientôt. Voir Webhooks →

💡
Astuce : Pour constituer des listes en temps réel, utilisez l'API de vérification unitaire pour vérifier les adresses au fur et à mesure de leur collecte. La vérification en masse convient mieux au nettoyage de listes existantes.