Traitement en lot

Classifiez des milliers d'adresses email ou de domaines en une seule requête. Importez un fichier CSV et téléchargez les résultats une fois le traitement terminé.

Fonctionnement

1. Importez un fichier CSV contenant des emails ou domaines (un par ligne)
2. EmailKind traite chaque élément de manière asynchrone en arrière-plan
3. Vérifiez le statut du job via l'API ou le dashboard
4. Téléchargez les résultats au format CSV une fois terminé

Créer un job

POST /v1/bulk
Content-Type: multipart/form-data

curl -X POST -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  -F "[email protected]" \
  -F "enrich=true" \
  "https://emailkind.com/v1/bulk"

Paramètres :

| Champ | Type | Requis | Description | |---|---|---|---| | file | fichier | Oui | Fichier CSV (max 2 Mo, max 10 000 lignes) | | enrich | string | Non | true pour inclure l'enrichissement entreprise |

Réponse (202 Accepted) :

{
  "success": true,
  "request_id": "req_abc123",
  "job": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "total_items": 1500,
    "created_at": "2025-01-15T10:30:00Z"
  }
}

Vérifier le statut

GET /v1/bulk/{id}

curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  "https://emailkind.com/v1/bulk/550e8400-e29b-41d4-a716-446655440000"

Statuts :

| Statut | Description | |---|---| | pending | Job créé, en attente | | processing | Classification en cours | | completed | Terminé, résultats disponibles | | failed | Erreur lors du traitement |

Télécharger les résultats

GET /v1/bulk/{id}/results

curl -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  -o resultats.csv \
  "https://emailkind.com/v1/bulk/550e8400-e29b-41d4-a716-446655440000/results"

Retourne un CSV avec les colonnes : input, domain, provider_id, provider_name, provider_type, is_business, is_free, is_disposable, is_education, confidence, et optionnellement company_name, company_source.

Lister les jobs

GET /v1/bulk

Retourne les 20 derniers jobs de votre compte.

Format CSV d'entrée

Le CSV doit contenir un email ou domaine par ligne dans la première colonne. L'en-tête est détecté et ignoré automatiquement.

Exemple :

email
[email protected]
[email protected]
[email protected]

Limites

• Maximum 10 000 éléments par fichier
• Maximum 2 Mo de taille de fichier
• Maximum 3 jobs simultanés par compte
• Disponible à partir du plan Starter
• Non disponible en mode sandbox

Webhooks

Un événement bulk.completed est envoyé quand un job est terminé :

{
  "event": "bulk.completed",
  "timestamp": "2025-01-15T10:35:00Z",
  "data": {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "total_items": 1500,
    "status": "completed"
  }
}

Notification email

Un email de notification est envoyé au propriétaire du compte à la fin du traitement.