En résumé : L’API Rodz propose trois endpoints d’enrichissement de contacts :
/enrich/contactpour obtenir le profil complet d’un prospect,/enrich/find-emailpour trouver son email professionnel et/enrich/reverse-emailpour identifier une personne à partir de son adresse. Ce guide détaille chaque endpoint avec des exemples concrets, les formats de requête et de réponse, et des cas d’usage pour votre prospection B2B.
Qu’est-ce que l’enrichissement de contacts B2B ?
L’enrichissement de contacts B2B consiste à compléter les informations dont vous disposez sur un prospect ou un client professionnel. Vous partez d’une donnée brute (un nom, une URL LinkedIn, une adresse email) et vous obtenez en retour un profil complet : intitulé de poste, nom de l’entreprise, numéro de téléphone, profils sociaux, email vérifié.
Dans un contexte de prospection commerciale, cette étape est fondamentale. Un CRM rempli de noms sans coordonnées exploitables ne sert à rien. L’enrichissement transforme une liste de prospects passifs en une base de données actionnable, prête à alimenter vos séquences d’emailing, vos campagnes de cold call ou vos workflows d’automatisation.
Le marché de l’enrichissement B2B est dominé par des outils comme Dropcontact, Fullenrich, Lusha, Kaspr ou Apollo. Chacun propose sa propre approche, ses propres sources de données et ses propres limites. L’API Rodz se distingue en intégrant l’enrichissement de contacts directement dans la même plateforme que les signaux d’affaires. Vous n’avez plus besoin de jongler entre plusieurs fournisseurs. Détection du signal, enrichissement du contact et déclenchement de l’action commerciale se font dans un seul pipeline.
Ce guide technique couvre les trois endpoints d’enrichissement de contacts disponibles dans l’API Rodz. Pour chaque endpoint, vous trouverez une description fonctionnelle, le format de la requête, un exemple cURL, le format de la réponse et un cas d’usage concret. Si vous n’avez pas encore configuré votre accès API, commencez par le guide de démarrage.
Prérequis
Avant de tester les endpoints d’enrichissement, vérifiez que vous disposez des éléments suivants :
- Un compte Rodz actif avec accès API. L’enrichissement de contacts nécessite un plan qui inclut les endpoints
/enrich/*. Vérifiez votre plan dans votre tableau de bord sur app.rodz.io. - Votre clé API. Récupérez-la depuis les paramètres de votre compte. Le guide de démarrage détaille la procédure.
- cURL ou un client HTTP. Les exemples de cet article utilisent cURL, mais vous pouvez utiliser Postman, Insomnia ou le client HTTP de votre langage favori.
- Une compréhension de base du format JSON. Toutes les requêtes et réponses utilisent ce format.
- La documentation de référence à portée de main. La référence API complète regroupe tous les endpoints, limites de débit et codes d’erreur.
Endpoint 1 : POST /enrich/contact, l’enrichissement complet
Ce que fait cet endpoint
L’endpoint POST /enrich/contact est le plus complet des trois. Il prend en entrée un identifiant de contact (une URL LinkedIn, ou un couple nom + entreprise) et renvoie un profil enrichi contenant toutes les informations disponibles : nom complet, intitulé de poste, entreprise, email professionnel, numéro de téléphone direct, profils sociaux (LinkedIn, Twitter/X) et localisation.
C’est l’endpoint à privilégier lorsque vous avez besoin du maximum d’informations sur un prospect. Par exemple, quand vous détectez un signal d’affaires pertinent et que vous souhaitez contacter la bonne personne dans l’entreprise concernée.
Format de la requête
URL : https://api.rodz.io/v1/enrich/contact
Méthode : POST
En-têtes :
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
Corps de la requête (option 1, via LinkedIn) :
{
"linkedin_url": "https://www.linkedin.com/in/exemple-prospect"
}
Corps de la requête (option 2, via nom + entreprise) :
{
"first_name": "Marie",
"last_name": "Dupont",
"company": "Acme Corp"
}
Vous pouvez aussi combiner les deux approches. Si vous fournissez l’URL LinkedIn et le nom, l’API croise les sources pour maximiser la fiabilité des résultats.
Format de la réponse
{
"status": "found",
"contact": {
"first_name": "Marie",
"last_name": "Dupont",
"full_name": "Marie Dupont",
"title": "Directrice Marketing",
"company": {
"name": "Acme Corp",
"domain": "acme-corp.com",
"industry": "SaaS",
"size_range": "51-200",
"country": "FR"
},
"email": {
"address": "marie.dupont@acme-corp.com",
"status": "verified",
"confidence": 97
},
"phone": {
"direct": "+33612345678",
"type": "mobile"
},
"social_profiles": {
"linkedin": "https://www.linkedin.com/in/exemple-prospect",
"twitter": "https://twitter.com/mariedupont"
},
"location": {
"city": "Paris",
"country": "FR"
}
},
"credits_used": 1
}
Le champ email.confidence est un score de 0 à 100. Au-dessus de 90, l’adresse est considérée comme fiable. Entre 70 et 90, elle est probable mais nécessite une vérification supplémentaire. En dessous de 70, l’email est incertain et ne devrait pas être utilisé pour du cold emailing.
Exemple cURL
curl -X POST https://api.rodz.io/v1/enrich/contact \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"linkedin_url": "https://www.linkedin.com/in/exemple-prospect"
}'
Cas d’usage : enrichir les contacts après détection d’un signal
Vous avez configuré un signal d’affaires pour détecter les levées de fonds dans le secteur SaaS en France. L’API Rodz vous notifie qu’Acme Corp vient de lever 5 millions d’euros. Vous savez que le décideur pour votre solution est typiquement le ou la Directrice Marketing.
Avec /enrich/contact, vous envoyez le nom du contact identifié via LinkedIn et vous récupérez instantanément son email vérifié, son numéro de téléphone direct et son intitulé exact. Vous injectez ces données dans votre CRM et déclenchez une séquence de prospection personnalisée, en mentionnant la levée de fonds. Le timing est parfait, les données sont complètes. C’est exactement ce qui différencie une approche par signaux d’une prospection à l’aveugle.
Endpoint 2 : POST /enrich/find-email, la recherche d’email professionnel
Ce que fait cet endpoint
L’endpoint POST /enrich/find-email se concentre sur une seule mission : trouver l’adresse email professionnelle d’une personne. Vous fournissez un nom et une entreprise (ou une URL LinkedIn) et l’API vous renvoie l’email le plus probable, accompagné d’un score de confiance et d’un statut de vérification.
Cet endpoint est plus léger que /enrich/contact. Il consomme moins de crédits et répond plus rapidement. Il est idéal lorsque vous avez déjà les autres informations du contact (poste, téléphone, profil LinkedIn) et que seul l’email vous manque.
Format de la requête
URL : https://api.rodz.io/v1/enrich/find-email
Méthode : POST
En-têtes :
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
Corps de la requête (option 1, via nom + entreprise) :
{
"first_name": "Thomas",
"last_name": "Bernard",
"company": "TechVision SAS"
}
Corps de la requête (option 2, via nom + domaine) :
{
"first_name": "Thomas",
"last_name": "Bernard",
"domain": "techvision.fr"
}
Corps de la requête (option 3, via LinkedIn) :
{
"linkedin_url": "https://www.linkedin.com/in/thomas-bernard-techvision"
}
Fournir le domaine plutôt que le nom de l’entreprise améliore la précision. Quand vous connaissez le site web de l’entreprise cible, utilisez le champ domain en priorité.
Format de la réponse
{
"status": "found",
"email": {
"address": "thomas.bernard@techvision.fr",
"status": "verified",
"confidence": 95,
"pattern": "{first}.{last}@{domain}",
"sources_count": 3
},
"alternatives": [
{
"address": "t.bernard@techvision.fr",
"confidence": 72,
"status": "unverified"
}
],
"credits_used": 0.5
}
Le champ pattern indique le format email détecté pour le domaine de l’entreprise. Le champ alternatives liste les adresses possibles avec un score de confiance plus faible. Le champ sources_count indique combien de sources distinctes confirment l’adresse principale.
Exemple cURL
curl -X POST https://api.rodz.io/v1/enrich/find-email \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"first_name": "Thomas",
"last_name": "Bernard",
"domain": "techvision.fr"
}'
Cas d’usage : compléter une liste de prospection importée depuis LinkedIn
Vous avez exporté une liste de 200 prospects depuis LinkedIn Sales Navigator. Chaque ligne contient le nom, le prénom, le poste et l’entreprise, mais aucune adresse email. Vous ne pouvez pas lancer votre campagne d’emailing sans ces adresses.
Avec /enrich/find-email, vous itérez sur votre liste en envoyant une requête par contact. L’API vous renvoie l’email vérifié pour chacun d’entre eux. Vous filtrez les résultats par score de confiance (en ne gardant que ceux au-dessus de 85) et vous obtenez une base de données de prospection propre, prête pour votre séquence d’emailing. Le tout en quelques minutes, sans intervention manuelle.
Pour traiter des volumes importants, pensez à respecter les limites de débit de l’API et à implémenter une logique de retry avec backoff exponentiel.
Endpoint 3 : POST /enrich/reverse-email, l’identification inversée
Ce que fait cet endpoint
L’endpoint POST /enrich/reverse-email fonctionne dans le sens inverse des deux précédents. Au lieu de chercher un email à partir d’un nom, il identifie une personne à partir de son adresse email. Vous fournissez une adresse email professionnelle et l’API renvoie le profil associé : nom, poste, entreprise, profils sociaux et localisation.
C’est un outil puissant pour les équipes qui reçoivent des leads entrants (via des formulaires, des inscriptions à des webinaires, des téléchargements de contenus) et qui ont besoin de qualifier rapidement ces contacts. L’adresse email est souvent la seule information disponible au moment de l’inscription. Le reverse email lookup vous permet de transformer cette donnée brute en un profil enrichi et exploitable.
Format de la requête
URL : https://api.rodz.io/v1/enrich/reverse-email
Méthode : POST
En-têtes :
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
Corps de la requête :
{
"email": "sophie.martin@innovatech.io"
}
La requête est simple : un seul champ obligatoire. L’API accepte les emails professionnels sur des domaines d’entreprise. Les adresses Gmail, Outlook ou Yahoo fonctionnent aussi, mais les résultats sont moins fiables car ces domaines ne sont pas liés à une entreprise spécifique.
Format de la réponse
{
"status": "found",
"person": {
"first_name": "Sophie",
"last_name": "Martin",
"full_name": "Sophie Martin",
"title": "Head of Sales",
"seniority": "director",
"department": "sales"
},
"company": {
"name": "InnovaTech",
"domain": "innovatech.io",
"industry": "Technology",
"size_range": "201-500",
"country": "FR",
"linkedin_url": "https://www.linkedin.com/company/innovatech"
},
"social_profiles": {
"linkedin": "https://www.linkedin.com/in/sophie-martin-innovatech"
},
"email_info": {
"deliverable": true,
"type": "professional",
"free_provider": false
},
"credits_used": 0.5
}
Le champ seniority catégorise le niveau hiérarchique du contact (intern, entry, senior, manager, director, vp, c-level). Le champ department identifie le service (sales, marketing, engineering, hr, finance, operations). Ces deux champs sont particulièrement utiles pour le routage automatique des leads vers la bonne équipe commerciale.
Exemple cURL
curl -X POST https://api.rodz.io/v1/enrich/reverse-email \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"email": "sophie.martin@innovatech.io"
}'
Cas d’usage : qualifier les leads entrants automatiquement
Votre site web propose un livre blanc en échange d’une adresse email. Chaque jour, vous recevez 30 à 50 nouvelles inscriptions. Votre équipe commerciale perd du temps à rechercher manuellement qui sont ces personnes, dans quelle entreprise elles travaillent et si elles correspondent à votre ICP (Ideal Customer Profile).
Avec /enrich/reverse-email, vous automatisez cette étape. Dès qu’un email arrive dans votre système, vous appelez l’endpoint et vous récupérez le profil complet. Vous utilisez le champ seniority pour prioriser les leads de niveau director ou c-level. Vous vérifiez que le champ company.size_range correspond à votre segment cible. Les leads qualifiés sont routés automatiquement vers le bon commercial, les autres entrent dans une séquence de lead nurturing.
Ce workflow élimine le travail manuel de qualification et réduit le temps de réponse. Un lead qui reçoit un premier contact dans l’heure a cinq fois plus de chances de se convertir qu’un lead contacté après 24 heures.
Comparatif : Rodz vs Lusha vs Kaspr vs Apollo pour l’enrichissement de contacts
Le tableau ci-dessous compare les principales fonctionnalités d’enrichissement de contacts entre Rodz, Lusha, Kaspr et Apollo. Il se concentre sur les capacités techniques, les sources de données et les cas d’usage principaux.
| Critère | Rodz | Lusha | Kaspr | Apollo |
|---|---|---|---|---|
| Enrichissement complet (profil) | Oui, via /enrich/contact | Oui | Oui | Oui |
| Recherche d’email | Oui, via /enrich/find-email | Oui | Oui | Oui |
| Reverse email lookup | Oui, via /enrich/reverse-email | Non | Non | Oui (limité) |
| Accès API REST | Oui, documenté | Oui | Non (extension uniquement) | Oui |
| Signaux d’affaires intégrés | Oui, 108 types de signaux | Non | Non | Signaux basiques |
| Score de confiance email | 0-100 avec statut de vérification | Oui/Non binaire | Score simplifié | Score en 3 niveaux |
| Emails alternatifs | Oui, avec score par alternative | Non | Non | Oui |
| Conformité RGPD | Conçu pour le marché européen | Conformité déclarée | Conformité déclarée | Conformité partielle |
| Sources de données | 350+ scrapers, 250+ sources | Base propriétaire | Données LinkedIn | Base communautaire + scraping |
| Pipeline unifié (signal + enrichissement) | Oui, un seul outil | Non, nécessite intégration | Non | Partiellement |
| Couverture France/Europe | Forte | Moyenne | Forte sur LinkedIn | Forte aux US, moyenne en Europe |
| Webhooks temps réel | Oui | Non | Non | Oui (limité) |
Le principal avantage de Rodz par rapport aux alternatives est l’intégration native entre les signaux d’affaires et l’enrichissement. Avec les autres outils, vous devez configurer un pipeline qui connecte un outil de détection de signaux à un outil d’enrichissement, puis à votre CRM. Avec Rodz, tout se fait dans la même API. Vous détectez un signal, vous enrichissez le contact et vous déclenchez l’action, le tout en quelques appels API.
Kaspr est un bon choix si votre workflow est centré sur LinkedIn et que vous n’avez pas besoin d’accès API. Lusha convient aux équipes commerciales qui préfèrent une extension navigateur simple. Apollo offre une base de données massive, particulièrement performante sur le marché américain. Pour la prospection B2B en France et en Europe, avec un besoin de signaux et d’enrichissement combinés, Rodz est la solution la plus intégrée.
Pour aller plus loin sur la qualité des données et les méthodes d’enrichissement, consultez notre guide sur l’enrichissement de données B2B.
Bonnes pratiques pour l’enrichissement de contacts via API
Avant de passer aux questions fréquentes, voici quelques recommandations pour tirer le meilleur parti des endpoints d’enrichissement.
Privilégiez l’URL LinkedIn quand elle est disponible. C’est l’identifiant le plus fiable pour un contact B2B. Il évite les ambiguïtés liées aux homonymes et améliore le taux de correspondance.
Utilisez le bon endpoint pour le bon besoin. Si vous avez uniquement besoin de l’email, utilisez /enrich/find-email plutôt que /enrich/contact. Vous consommerez moins de crédits et obtiendrez une réponse plus rapide.
Filtrez par score de confiance. Ne lancez jamais une campagne d’emailing avec des adresses dont le score de confiance est inférieur à 85. Vous risquez des bounces qui détériorent votre délivrabilité.
Mettez en cache les résultats. Les données d’enrichissement ne changent pas d’heure en heure. Stockez les résultats dans votre CRM ou votre base de données et ne ré-enrichissez un contact que tous les 30 à 90 jours.
Respectez les limites de débit. L’API Rodz impose des limites par minute et par jour selon votre plan. Implémentez un système de queue avec retry automatique. Consultez la référence API pour les limites exactes.
Combinez enrichissement et signaux. La vraie puissance de l’API Rodz apparait quand vous connectez la détection de signaux à l’enrichissement automatique. Configurez un webhook qui déclenche l’enrichissement dès qu’un signal est détecté.
Questions fréquentes
Quelle est la différence entre /enrich/contact et /enrich/find-email ?
/enrich/contact renvoie le profil complet du contact : nom, poste, entreprise, email, téléphone, profils sociaux et localisation. /enrich/find-email se concentre uniquement sur la recherche de l’adresse email professionnelle. Le premier consomme plus de crédits mais fournit un profil exhaustif. Le second est plus léger et plus rapide. Utilisez /enrich/contact quand vous construisez un profil prospect depuis zéro. Utilisez /enrich/find-email quand vous avez déjà les autres informations et qu’il vous manque seulement l’email.
Le reverse email fonctionne-t-il avec les adresses Gmail ou Outlook ?
Techniquement, oui. L’API accepte tous les types d’adresses email. Cependant, les résultats sont nettement plus fiables avec des adresses sur des domaines d’entreprise (exemple : sophie.martin@innovatech.io). Avec des fournisseurs gratuits (Gmail, Outlook, Yahoo), l’API peut trouver le nom associé, mais les informations professionnelles seront souvent incomplètes ou absentes. Pour maximiser vos résultats, privilégiez les adresses professionnelles.
Combien de crédits consomme chaque endpoint ?
La consommation varie selon l’endpoint et votre plan. En règle générale, /enrich/contact consomme 1 crédit par requête réussie. /enrich/find-email et /enrich/reverse-email consomment chacun 0,5 crédit. Les requêtes qui renvoient un statut not_found ne consomment pas de crédits. Consultez votre tableau de bord sur app.rodz.io pour voir votre consommation en temps réel et les détails de votre plan.
Puis-je enrichir des contacts en masse via l’API ?
Oui, en itérant sur votre liste de contacts avec des requêtes individuelles. L’API ne propose pas de endpoint batch natif, mais vous pouvez paralléliser les appels en respectant les limites de débit (typiquement 60 requêtes par minute selon le plan). Pour des volumes importants (plus de 10 000 contacts), contactez l’équipe Rodz pour discuter d’un plan adapté et d’éventuelles limites de débit augmentées.
Les données d’enrichissement sont-elles conformes au RGPD ?
Rodz est conçu pour le marché européen et traite les données en conformité avec le RGPD. Les données collectées proviennent de sources publiquement accessibles (profils LinkedIn publics, sites d’entreprise, bases légales). Aucune donnée personnelle sensible n’est collectée. Cela dit, en tant qu’utilisateur de l’API, vous êtes responsable de l’utilisation que vous faites des données récupérées. Assurez-vous d’avoir une base légale valide (intérêt légitime dans le cadre de la prospection B2B) et d’informer les personnes concernées conformément à l’article 14 du RGPD. Pour approfondir ce sujet, lisez notre article sur le RGPD et les signaux d’affaires.
Quel est le taux de correspondance moyen ?
Le taux de correspondance dépend du type de requête et de la qualité des données en entrée. Avec une URL LinkedIn valide, le taux de correspondance pour /enrich/contact dépasse 85 %. Avec un nom et une entreprise, il se situe entre 70 % et 80 %. Pour /enrich/find-email, le taux d’emails trouvés et vérifiés est d’environ 75 % sur le marché français et européen. Pour /enrich/reverse-email, le taux de correspondance est d’environ 80 % sur les domaines d’entreprise et tombe à 40 % pour les fournisseurs d’email gratuits.
Comment gérer les cas où l’API ne trouve pas de résultat ?
Quand l’API ne trouve pas de correspondance, elle renvoie un statut not_found sans consommer de crédits. Dans ce cas, vous pouvez tenter une deuxième requête avec des paramètres différents. Par exemple, si la recherche par nom + entreprise échoue, essayez avec l’URL LinkedIn. Vous pouvez aussi combiner les approches : lancez d’abord /enrich/find-email pour obtenir l’email, puis utilisez /enrich/reverse-email sur le résultat pour croiser les données.
Puis-je intégrer l’enrichissement dans un workflow automatisé avec les webhooks Rodz ?
Absolument. C’est même l’usage recommandé. Configurez un webhook pour recevoir les signaux d’affaires en temps réel. Quand votre serveur reçoit un signal, il extrait les informations du contact associé et appelle /enrich/contact ou /enrich/find-email pour compléter le profil. Les données enrichies sont ensuite poussées dans votre CRM. Ce pipeline automatise entièrement la chaine détection, enrichissement et action commerciale. La documentation API complète décrit les formats de payload des webhooks et les bonnes pratiques d’intégration.
Prochaines étapes
Vous maitrisez maintenant les trois endpoints d’enrichissement de contacts de l’API Rodz. Pour construire un pipeline de prospection complet, explorez les ressources suivantes :
- Guide de démarrage API pour configurer votre authentification si ce n’est pas encore fait
- Référence API complète pour consulter tous les endpoints, les limites de débit et les codes d’erreur
- Configurer les webhooks pour automatiser la réception des signaux et déclencher l’enrichissement en temps réel
- Documentation interactive pour tester les endpoints directement depuis votre navigateur
L’enrichissement de contacts prend tout son sens quand il est connecté à la détection de signaux d’affaires. Un email trouvé au bon moment, sur le bon décideur, dans une entreprise qui vient de donner un signal d’achat : c’est la recette d’une prospection qui convertit.