Skip to main content
POST
POST
Lancez une recherche d’email unique pour trouver une adresse email professionnelle. Authentifiez chaque requête avec votre clé API dans l’en-tête x-api-key. Pour les opérations par lot, utilisez le endpoint Trouver des emails (jusqu’à 5 000 recherches par lot). La recherche nécessite, au choix :
  • Un nom complet et une entreprise : fullname + (company_domain ou company_name)
  • L’URL du profil LinkedIn d’une personne dans linkedin_url (voir Recherche par URL de profil LinkedIn)
Si les deux sont fournis, la recherche porte sur le nom et l’entreprise.
Enrow effectue des vérifications déterministes qui valident même les emails catch-all. Cela signifie qu’il n’est pas nécessaire de faire passer les emails trouvés par un debouncer ensuite.

Request Body

string
Le nom complet de la personne pour laquelle trouver l’emailNote : requis pour une recherche par nom et entreprise, pas pour une recherche à partir de linkedin_url.
string
Le domaine de l’entreprise, plusieurs formats acceptés ("dundermifflin.com", "https://www.dundermifflin.com"…)Note : company_domain ou company_name est requis pour une recherche par nom et entreprise.
string
Le nom de l’entreprise ("Apple", "Air France", …)Note : company_domain ou company_name est requis pour une recherche par nom et entreprise.
string
L’URL du profil LinkedIn de la personne ("https://www.linkedin.com/in/dwight-schrute"), pour lancer la recherche à partir du profil plutôt que d’un nom et d’une entreprise. Voir Recherche par URL de profil LinkedIn.Note : pris en compte uniquement si la requête n’est pas une recherche complète par nom et entreprise. Avec un fullname et une entreprise, linkedin_url est ignoré.
object
Paramètres personnalisés qui seront renvoyés dans la réponse GET et dans la notification webhook.
object
Un ensemble de paramètres liés à cette recherche

Response

200 — Recherche lancée

string
Message de confirmation
string
Identifiant unique de cette recherche. Utilisez-le pour récupérer les résultats via le endpoint GET.
number
Nombre de crédits consommés. Voir Crédits et facturation pour les coûts par endpoint.

Réponses d’erreur

Les réponses pour crédits insuffisants (402) sur les endpoints uniques renvoient { "reason": "...", "success": false } ; toutes les autres erreurs renvoient { "message": "..." }.
Voir Gestion des erreurs pour la liste complète des codes de statut et des formats de réponse.

Recherche par URL de profil LinkedIn

Envoyez l’URL du profil LinkedIn d’une personne dans linkedin_url au lieu d’un nom complet et d’une entreprise. Enrow lit le profil, identifie l’entreprise actuelle de la personne, puis y trouve et vérifie son email professionnel. La recherche se déroule comme toute autre recherche unitaire : la réponse 200 vous donne son id, et le résultat arrive via le endpoint GET ou votre webhook. custom et settings fonctionnent de la même façon.
La recherche à partir d’une URL de profil LinkedIn ne fonctionne qu’en recherche unitaire et n’est pas forcément disponible sur tous les comptes. Si votre compte n’y a pas accès, une requête qui ne contient qu’un linkedin_url reçoit l’erreur de validation habituelle, par exemple missing fullname. Contactez api@enrow.io si vous en avez besoin.

Quand la recherche utilise-t-elle le profil ?

La recherche part du profil lorsque linkedin_url est fourni et que la requête n’est pas une recherche complète par nom et entreprise :
  • fullname est absent, vide ou ne contient qu’un seul caractère, ou
  • ni company_domain ni company_name n’est fourni.
Une requête avec un fullname et une entreprise reste une recherche par nom et entreprise, même avec un linkedin_url. Lorsque la recherche part du profil, le nom et l’entreprise viennent du profil : un fullname, un company_domain ou un company_name envoyé en plus est ignoré.

Quelles URL sont acceptées ?

Toute autre valeur est refusée avec une erreur 400 et le message invalid linkedin_url format : une page entreprise (linkedin.com/company/...), un lien court lnkd.in, une page hors de linkedin.com, ou un nom de profil sans l’URL.

Comment Enrow choisit-il l’entreprise ?

Enrow cherche l’email dans l’entreprise actuelle de la personne, telle qu’elle figure sur le profil. Si plusieurs postes sont en cours, il retient le premier de la liste. Les postes sans employeur, comme indépendant, freelance ou étudiant, sont ignorés. Un profil sans poste actuel chez un employeur termine la recherche avec no_current_company.

Combien coûte la recherche ?

Au lancement, la recherche consomme 1 crédit, comme toute recherche (credits_used: 1 dans la réponse). À la fin, la différence est remboursée : la recherche coûte 1 crédit si un email est trouvé, 0,25 crédit si aucun email n’est trouvé, et rien si elle échoue à cause d’un problème de notre côté. Le résultat indique la raison dans linkedin_status et le coût final dans credits_used. Voir Crédits et facturation.

Exemple

La réponse est la même que pour une recherche par nom et entreprise :

Étapes suivantes

Récupérer le résultat

Récupérez l’email trouvé à l’aide de l’id de la recherche.

Trouver des emails en masse

Lancez jusqu’à 5 000 recherches d’emails en une seule requête.

Authentification

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

Webhooks

Soyez notifié automatiquement lorsqu’une recherche se termine.