curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
Email Finder
Résultats des emails
Récupérez les résultats, les statistiques et le détail des crédits d’une recherche d’emails groupée à partir de l’ID du lot
GET
/
email
/
find
/
bulk
curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
GET
Récupérez tous les résultats d’une recherche d’emails groupée à l’aide de l’ID du lot. Authentifiez chaque requête avec votre clé API dans l’en-tête
Consultez Gestion des erreurs pour la liste complète des codes de statut et des formats de réponse.
https://api.enrow.io/email/find/bulk?id={id}
x-api-key. L’ID du lot est l’id renvoyé lorsque vous lancez une tâche avec l’endpoint Find Bulk Emails.
L’utilisation d’un webhook vous permet d’éviter d’appeler cet endpoint GET. Voir Fonctionnement des webhooks.
Paramètres de requête
string
requis
L’
id renvoyé par la requête POSTRéponse
200 — Recherche terminée
object
object
Statistiques du lot
Afficher propriétés de stats
Afficher propriétés de stats
number
Nombre de recherches terminées
number
Nombre total de recherches demandées
number
Nombre d’emails valides trouvés
object
Détail des crédits. Les crédits sont remboursés pour les résultats invalides ou non trouvés — consultez Crédits et facturation pour comprendre le fonctionnement des facturations et des remboursements.
array
Tableau des résultats de recherche
Afficher propriétés de Result
Afficher propriétés de Result
string
Position dans le tableau de recherche initial
string
valid (email trouvé) ou invalid (email non trouvé). Pourquoi binaire ?string
L’adresse email découverte (lorsque
valid)object
Informations de contact :
domain, firstname, lastname, gender, companyInfo. Les valeurs firstname et lastname ont une initiale en majuscule. info n’est présent que pour les résultats valides.object
Les paramètres de recherche initiaux envoyés
string | object
Données personnalisées transmises dans la recherche initiale
200 — Recherche encore en cours
Pendant l’exécution du lot, l’endpoint GET renvoie un statut HTTP200 avec un corps réduit de la forme { general: { id, status: "ongoing" }, stats: { finished, requested } }.
object
id et status: "ongoing"object
Compteurs
finished et requestedRéponses d’erreur
| Code | Message |
|---|---|
| 400 | Could not retrieve bulk search results |
curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
Étapes suivantes
Rechercher des emails en masse
Lancez un nouveau lot pouvant compter jusqu’à 5 000 recherches d’emails.
Webhooks
Évitez le polling et soyez notifié dès qu’un lot est terminé.
Crédits et facturation
Découvrez comment les crédits sont débités et remboursés par résultat.
Vérifier des emails en masse
Validez une liste d’adresses email en un seul lot.
Cette page vous a-t-elle été utile ?

