Passer au contenu principal
POST
/
email
/
find
/
bulk
curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}
POST 
https://api.enrow.io/email/find/bulk
Lancez plusieurs recherches d’e-mails en une seule requête. Jusqu’à 5 000 recherches par lot. Authentifiez chaque requête avec votre clé API dans l’en-tête x-api-key. Pour trouver un seul e-mail à la place, utilisez l’endpoint Trouver un e-mail.
Enrow effectue des vérifications déterministes qui valident même les e-mails catch-all. Aucun debouncer nécessaire.

​
Request Body

​
searches
array of objects
requis
Charges utiles de recherche pour lesquelles trouver les e-mails correspondants.
​
custom
object
Paramètres personnalisés qui seront renvoyés dans la réponse GET et dans la notification du webhook.
​
settings
object
Paramètres relatifs à l’ensemble de la recherche en masse.

​
Response

​
201 — Recherche en masse démarrée

​
message
string
Message de confirmation
​
id
string
Identifiant unique de ce lot. Utilisez-le pour récupérer les résultats via l’endpoint GET.
​
credits_used
number
Total des crédits consommés. Voir Crédits et facturation pour les coûts par endpoint.
​
estimated_duration
number
Temps de traitement estimé en minutes (non garanti)

​
Réponses d’erreur

CodeMessage
400Missing payload
400Missing searches payload
400Too many searches. Limit is currently at 5000 per batch.
400Error while parsing payload
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
En cas de crédits insuffisants, l’endpoint de masse renvoie le code HTTP 402 avec un corps de la forme { "message": "..." }. Voir Gestion des erreurs pour la liste complète des codes de statut et des formats de réponse.
curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}

​
Étapes suivantes

Récupérer les résultats en masse

Récupérez les e-mails trouvés à l’aide de l’id du lot.

Trouver un e-mail

Lancez une recherche d’e-mail unique à partir d’un nom et d’une entreprise.

Webhooks

Soyez notifié automatiquement lorsqu’un lot se termine.

Crédits et facturation

Découvrez comment les crédits sont consommés pour chaque endpoint.