Récupérer un résultat

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

find

single

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

https://api.enrow.io/email/find/single?id={id}

Récupérez le résultat d’une recherche d’email lancée précédemment à l’aide de son ID unique. Authentifiez chaque requête avec votre clé API dans l’en-tête x-api-key.

L’utilisation d’un webhook vous permet d’éviter d’appeler ce point de terminaison GET, car vous serez notifié dès la seconde où votre recherche est terminée. Consultez Comment fonctionnent les webhooks.

Paramètres de requête

string

requis

L’identifiant unique renvoyé par la requête POST

Réponse

200 — Recherche terminée

string

L’adresse email découverte

string

valid (email trouvé) ou invalid (email non trouvé). Pourquoi binaire ?

number

Coût final de la recherche, remboursements faits : 1 pour un email trouvé, 0 pour un email introuvable (0.25 pour une recherche à partir d’une URL de profil LinkedIn ou pour un compte au taux de succès anormalement bas, voir Crédits et facturation). Une recherche à partir d’une URL de profil LinkedIn qui échoue à cause d’un problème de notre côté coûte 0 : voir Résultats des recherches par URL de profil LinkedIn.

object

Informations sur le contact et l’entreprise. Pour une recherche à partir d’une URL de profil LinkedIn, présent uniquement si un email est trouvé.

Afficher propriétés de info

string

Domaine de l’entreprise

string

Nom de l’entreprise

string

Nom complet tel que fourni dans la requête

string

Prénom

string

Nom de famille

string

Genre (male ou female) — uniquement si retrieve_gender était défini sur true

object

Propriétés personnalisées transmises dans la requête d’origine, renvoyées telles quelles

string

Recherche à partir d’une URL de profil LinkedIn uniquement. Comment la recherche s’est terminée : found, profile_not_found, no_current_company, email_not_found ou lookup_failed. Consultez Résultats des recherches par URL de profil LinkedIn.

string

Recherche à partir d’une URL de profil LinkedIn uniquement. Le linkedin_url que vous avez envoyé.

202 — Recherche toujours en cours

string

ongoing — la recherche n’est pas encore terminée. Réinterrogez sous peu, ou utilisez un webhook pour être notifié automatiquement. La récupération d’un résultat ne consomme pas de crédits ; consultez Crédits et facturation.

Réponses d’erreur

Code	Message
400	`The single search id is missing in the URL query string`
500	`Could not retrieve single search results`

Consultez Gestion des erreurs pour la liste complète des codes de statut et des formats de réponse.

Résultats des recherches par URL de profil LinkedIn

Une recherche lancée à partir d’une URL de profil LinkedIn conserve la qualification binaire et ajoute deux champs : linkedin_status, qui indique comment la recherche s’est terminée, et linkedin_url, l’URL que vous avez envoyée.

`linkedin_status`	Signification	`qualification`	`credits_used`
`found`	L’email professionnel de la personne a été trouvé et vérifié	`valid`	`1`
`profile_not_found`	Aucun profil trouvé à cette URL LinkedIn	`invalid`	`0.25`
`no_current_company`	Le profil n’indique aucun poste actuel où chercher	`invalid`	`0.25`
`email_not_found`	Profil trouvé, mais aucun email dans l’entreprise actuelle de la personne	`invalid`	`0.25`
`lookup_failed`	La recherche n’a pas pu aboutir à cause d’un problème de notre côté. Elle est entièrement remboursée : réessayez dans quelques minutes	`invalid`	`0`

Lorsque l’email est trouvé, info donne le nom et l’entreprise lus sur le profil : firstname, lastname, company_name et company_domain, ainsi que gender lorsque retrieve_gender vaut true. Dans tous les autres cas, la réponse ne contient ni email ni info : elle n’indique jamais à qui appartient le profil. Si l’email ou le profil figure sur votre liste de suppression, l’email trouvé n’est pas communiqué : le résultat indique email_not_found et coûte 1 crédit, comme un email trouvé. Tant que la recherche est en cours, l’endpoint renvoie le 202 habituel avec qualification: "ongoing".

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "crm_id": "lead_001"
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "company_name": "Dunder Mifflin",
    "firstname": "Dwight",
    "lastname": "Schrute"
  },
  "linkedin_status": "found",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "valid",
  "credits_used": 1
}

{
  "custom": {
    "crm_id": "lead_001"
  },
  "linkedin_status": "no_current_company",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "invalid",
  "credits_used": 0.25
}

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

Étapes suivantes

Trouver un email

Lancez une recherche d’email unique pour obtenir un id de recherche.

Récupérer des résultats

Récupérez les résultats d’une recherche d’emails en masse.

Webhooks

Soyez notifié automatiquement lorsqu’une recherche se termine.

Authentification

Comment transmettre votre clé API dans l’en-tête x-api-key.

Démarrage

Email Finder

Email Verifier

Phone Finder

Compte

Paramètres de requête

Réponse

200 — Recherche terminée

202 — Recherche toujours en cours

Réponses d’erreur

Résultats des recherches par URL de profil LinkedIn

Étapes suivantes

Trouver un email

Récupérer des résultats

Webhooks

Authentification

​Paramètres de requête

​Réponse

​200 — Recherche terminée

​202 — Recherche toujours en cours

​Réponses d’erreur

​Résultats des recherches par URL de profil LinkedIn

​Étapes suivantes

Trouver un email

Récupérer des résultats

Webhooks

Authentification

Paramètres de requête

Réponse

200 — Recherche terminée

202 — Recherche toujours en cours

Réponses d’erreur

Résultats des recherches par URL de profil LinkedIn

Étapes suivantes