Trouver l'adresse email professionnelle d'un contact

Sortir les adresses déjà présentes dans la base, sans rien enrichir

Avant de chercher quoi que ce soit, une partie du travail est déjà faite : Basile a relevé sur les sites d'entreprises les adresses qui y étaient publiées, et les rattache par le nom de domaine. Elles sortent à l'export sans un centime d'enrichissement, par la plateforme comme par une clé d'API. La contrepartie est celle du chapitre : ce sont presque toujours des adresses génériques, du contact@, et pas le nominatif d'une personne.

Dans la plateforme, pas à pas

1. Ouvrez la recherche Entreprises et posez vos critères habituels (activité, code postal, effectif, entreprises actives uniquement).
2. Dans l'encart « Avec : » du panneau de filtres, activez la bascule « Email ». Elle ne garde que les sociétés dont le domaine porte au moins une adresse relevée.
3. Regardez le compteur de résultats avant d'aller plus loin. La chute est brutale et c'est normal (voir la note ci-dessous).
4. Cliquez sur « Exporter », puis dans « Exporter en CSV » choisissez le format : « Par entreprise » pour une ligne par société, « Par point de vente » pour une ligne par établissement Google.
5. Dans le fichier, lisez la colonne crawled_emails (les adresses relevées, séparées par des points-virgules) et le drapeau has_crawled_email. Le fill_score de la ligne vous dit d'un coup d'œil ce qui est rempli et ce qui ne l'est pas.

Trois réserves, qu'il vaut mieux connaître avant de conclure que le filtre est cassé. Le drapeau has_email n'est posé aujourd'hui que sur 180 278 fiches entreprises : la bascule n'ouvre pas un gisement caché, elle isole une petite minorité déjà couverte. C'est un filtre ET appliqué à chacune des trois sources et non un sélecteur de source : combinée à des critères qui ne vivent que dans le registre légal (code postal, code NAF, département, forme juridique), elle rétrécit très vite. Enfin, du côté Personnes, il n'existe pas de bascule équivalente : le panneau de filtres contacts n'a pas de « Avec email ». Vous exportez, puis vous triez sur la colonne.

Par l'API : POST /companies/export

{
  "filters": {
    "with_email": true,
    "company_ceased": false,
    "activity": { "include": ["esn_developpement_logiciel"] },
    "headquarters_postal_code": { "include": ["75008", "75009", "75017"] }
  },
  "mode": "companies"
}

Un flux CSV (text/csv; charset=utf-8), servi en pièce jointe. Les colonnes qui portent l'information cherchée sont crawled_emails et has_crawled_email. Sur la même ligne vous trouverez aussi le contact téléphonique de la société (gmb_phone, crawled_phones), son identité légale (legal_siren, legal_naf, legal_capital, legal_tranche_effectif) et son fill_score. Avec "mode": "locations", la même requête rend une ligne par établissement Google au lieu d'une ligne par société.

Comptez avant d'exporter : le même bloc filters envoyé à POST /companies/find avec "countOnly": true renvoie le total sans débiter de crédit. Lisez ce total comme un majorant, pas comme un décompte à l'unité : la déduplication exacte entre les trois sources n'est calculée qu'en dessous de 2 000 résultats, au-dessus le chiffre est la somme brute et une société vue dans deux sources y compte deux fois (mesuré : 4 335 annoncés pour 3 627 lignes réellement exportées). Attention à la pagination : /find se pilote avec limit (1000 au maximum par page pour des fiches complètes) et page ou paginationToken, pas avec un couple from/to. Deux garde-fous s'appliquent à l'export par clé d'API : au moins un filtre effectif est exigé (un corps sans filtre reçoit un 400 « At least one filter is required »), et le nombre de lignes est plafonné par votre forfait (20 000 par export sur le plan API). Côté personnes, POST /people/export accepte un corps de même forme et porte lui aussi une colonne crawled_emails, mais elle y est très clairsemée : l'adresse relevée vit au niveau du domaine de la société, pas du contact. Et aucun filtre with_email n'existe dans les filtres personnes : le tri se fait sur la colonne, après coup.

Le détail des champs, des filtres et des codes de réponse est dans la documentation de l'API.

Avec Claude, en langage courant

Combien d'ESN actives dans les 8e, 9e et 17e arrondissements de Paris ont une adresse email relevée sur leur site ? Si c'est moins de cinq cents, sors-moi le CSV.

Claude enchaîne basile_activity_suggest, basile_count puis basile_export.

basile_count ne débite aucun crédit : c'est toujours le premier appel, et c'est lui qui vous évite de payer pour découvrir qu'il n'y a rien. Une réserve à garder en tête sur le chiffre rendu : au-delà de 2 000 résultats, le total entreprises est la somme brute des trois sources, donc un majorant ; côté personnes, une même personne présente au registre et sur LinkedIn est comptée deux fois. C'est un ordre de grandeur haut, pas un décompte à l'unité. basile_export consomme le quota d'export de votre forfait et rend le CSV directement dans la conversation, ce qui le limite à 500 lignes : au-delà, il refuse et vous renvoie vers l'export de la plateforme, qui produit un vrai fichier. basile_activity_suggest sert à trouver l'identifiant de concept d'activité à passer en filtre, plutôt que de le deviner.

Trouver l'adresse nominative d'un contact identifié

C'est la réponse directe à la question du chapitre, et elle remplace la déduction par convention. Vous ne pariez plus sur un format : vous demandez l'adresse, un fournisseur va la chercher puis la teste, et vous ne payez que si elle est trouvée. La recherche se déclenche fiche par fiche, sur la plateforme ou dans l'extension LinkedIn, et se règle sur votre solde (5 centimes par email trouvé au tarif standard, affiché sur la page du solde).

Dans la plateforme, pas à pas

1. Ouvrez la recherche Personnes et retrouvez le contact (nom, employeur, intitulé de poste).
2. Vérifiez que la fiche porte un nom complet et au moins un identifiant d'employeur : nom de domaine, nom commercial, raison sociale ou dénomination légale. C'est ce couple que le fournisseur reçoit, et il les essaie en cascade. Une fiche sans aucun employeur identifiable est écartée sans être facturée.
3. Sur la fiche, cliquez sur « Trouver l'e-mail ».
4. Si vous aviez déjà trouvé cette adresse par le passé, elle réapparaît aussitôt et gratuitement : une coordonnée déjà payée n'est jamais rachetée.
5. Sinon, l'écran de confirmation affiche le montant réservé sur votre solde avant tout débit. Confirmez, puis laissez le fournisseur répondre.
6. L'adresse trouvée s'affiche sur la fiche et rejoint la colonne person_email de vos exports.

Le même geste existe dans l'extension LinkedIn, sur le profil que vous êtes en train de consulter : bouton « Trouver l'email » du panneau latéral. Une borne à connaître : le chemin sur solde résout l'identité par identifiant de contact Basile, il ne sait donc traiter qu'une personne déjà présente dans la base. Pour les autres, c'est-à-dire le cas le plus fréquent sur LinkedIn, l'extension retombe sur votre clé Emelia personnelle, la seule à accepter un nom et un domaine libres. Deux issues sont normales et ne sont pas des pannes : « Introuvable », auquel cas rien n'est débité, et le statut indéterminé que produit un domaine en catch-all, décrit plus haut. Le solde n'exige aucun abonnement : un compte gratuit peut payer cinq centimes pour une adresse.

Par l'API : POST https://api.emelia.io/tools/find/email

// en-tête : Authorization: <votre clé Emelia, 48 caractères, sans « Bearer »>
{
  "fullname": "Marie Durand",
  "companyName": "Carrefour",
  "companyWebsite": "carrefour.fr",
  "country": "FR"
}

La réponse rend un identifiant de tâche. L'adresse arrive ensuite en interrogeant GET /tools/find/email/{jobId} jusqu'à ce que la tâche soit terminée : la recherche essaie plusieurs formats et les vérifie, ce qui prend quelques secondes.

Attention, ce n'est pas l'API de Basile. Aucune clé Basile n'ouvre l'enrichissement : elle donne accès à /people, /companies, /lists et /exports, c'est-à-dire à la donnée déjà présente. Pour aller chercher ce qui n'y est pas, il faut une clé Emelia, et c'est elle qui est facturée. Dans Basile, la même opération passe par le portefeuille : 5 centimes l'adresse trouvée, 50 centimes le numéro.

Le détail des champs, des filtres et des codes de réponse est dans la documentation de l'API.

Avec Claude, en langage courant

Le serveur MCP se facture comme une clé d'API et ouvre exactement les mêmes portes : la recherche, le comptage, l'export et la fiche. Aucun de ses sept outils ne déclenche d'enrichissement. Claude peut donc faire tout le travail d'avant, à savoir identifier la bonne personne avec basile_search_people puis lire sa fiche complète avec basile_get_entity, et vous rendre son identifiant ; le clic « Trouver l'e-mail » reste à faire dans la plateforme ou dans l'extension.

Enrichir toute une recherche d'un coup, plutôt que contact par contact

Passé quelques lignes, la fiche par fiche ne tient plus. L'enrichissement en masse prend la sélection entière, affiche un devis chiffré avant de lancer quoi que ce soit, puis tourne côté serveur : vous pouvez rafraîchir la page ou fermer l'onglet. Comme la recherche unitaire, il n'existe que dans la plateforme.

Dans la plateforme, pas à pas

1. Posez votre recherche Personnes jusqu'à ce que le résultat soit exactement celui que vous acceptez de payer. Le devis porte sur la sélection, pas sur ce qui aboutira : on affine avant, pas après.
2. Cochez « Sélectionner tous les résultats ». La sélection est plafonnée à 20 000 contacts par lancement ; au-delà, découpez avec « Sélectionner une tranche… ».
3. Cliquez sur « Trouver l'e-mail ». L'écran « Enrichissement sur votre solde » s'ouvre.
4. Lisez les quatre lignes du devis avant de valider : « À rechercher » (le seul poste facturable), « Déjà trouvés (resservis gratuitement) », « Sans données suffisantes (ignorés) », et « Votre solde ». Les fiches sans employeur identifiable (ni domaine, ni nom commercial, ni raison sociale, ni dénomination légale) tombent d'office dans la troisième ligne.
5. Validez avec « Lancer (réserver X) ». Le montant est réservé, pas débité : seules les adresses effectivement trouvées sont facturées, le reste revient sur votre solde à la fin du traitement.
6. Laissez tourner. Un seul enrichissement à la fois par compte (une seconde tentative reçoit un refus « enrichissement déjà en cours »), et la progression se retrouve après un rafraîchissement ou dans un autre onglet.
7. Une fois terminé, exportez en réglant « Contacts à inclure » sur « Avec email » : le CSV ne garde alors que les lignes dont vous possédez l'adresse nominative. L'option reste grisée tant qu'aucun email n'a été trouvé dans cette recherche.

Si vous avez enregistré votre propre clé Emelia dans les réglages, l'enrichissement passe par elle et consomme vos crédits Emelia : le tunnel est le même, sans l'écran de devis sur solde. Une remarque de méthode, qui vaut plus que le mode d'emploi : un enrichissement de masse lancé sur une recherche mal cadrée coûte le prix de la recherche mal cadrée. Le devis est le dernier endroit où cela se rattrape, et les trois premières lignes qu'il affiche sont là pour ça.

Par l'API : POST https://api.emelia.io/tools/find/email

// un appel par contact, à enchaîner depuis votre propre boucle
{
  "fullname": "Marie Durand",
  "companyName": "Carrefour",
  "companyWebsite": "carrefour.fr"
}

Il n'y a pas de route de lot : l'enrichissement en masse se fait en bouclant sur les contacts, un appel chacun, et en relevant les identifiants de tâche pour les interroger ensuite. C'est exactement ce que fait Basile derrière son bouton, avec en plus la reprise sur erreur et le suivi d'avancement.

Attention, ce n'est pas l'API de Basile. Aucune clé Basile n'ouvre l'enrichissement : elle donne accès à /people, /companies, /lists et /exports, c'est-à-dire à la donnée déjà présente. Pour aller chercher ce qui n'y est pas, il faut une clé Emelia, et c'est elle qui est facturée. Dans Basile, la même opération passe par le portefeuille : 5 centimes l'adresse trouvée, 50 centimes le numéro.

Le détail des champs, des filtres et des codes de réponse est dans la documentation de l'API.

Avec Claude, en langage courant

Même limite et même raison : le MCP est facturé comme une clé d'API et n'expose aucun outil d'enrichissement. Claude est utile de part et d'autre du geste, jamais pendant. Avant, il cadre la cible avec basile_count, qui ne débite rien, ce qui vous donne un ordre de grandeur du coût à cinq centimes l'email avant même d'ouvrir la plateforme. Retenez que ce compte de personnes est un majorant : une même personne présente au registre et sur LinkedIn y figure deux fois, et le devis de la plateforme, lui, chiffre la sélection réelle. Après, il récupère et met en forme le fichier avec basile_export. Le lancement lui-même se fait à l'écran.