En résumé : L’API Rodz expose trois endpoints d’enrichissement entreprise : firmographique, financier et SIRENE. Le premier renvoie le secteur, la taille, la tranche de chiffre d’affaires et la localisation. Le deuxième fournit le revenu réel, le taux de croissance, le financement total et les tendances d’effectifs. Le troisième interroge le registre français SIRENE pour récupérer SIREN, SIRET, code NAF, forme juridique et date d’immatriculation. Ce guide couvre chaque endpoint avec des requêtes cURL prêtes à l’emploi, les champs de réponse et des cas d’usage concrets.
Qu’est-ce que l’enrichissement de données entreprises ?
L’enrichissement de données, c’est compléter un enregistrement partiel (un nom d’entreprise, un domaine ou un identifiant) avec des informations structurées et vérifiées. En B2B, ça revient à transformer une ligne dans un tableur en fiche complète : secteur d’activité, taille d’équipe, données financières, identifiants légaux.
Pourquoi s’en préoccuper ? Parce que la qualité des données conditionne directement la pertinence du ciblage. Selon une analyse publiée sur ce blog, 69 % des entreprises échouent dans leur stratégie data-driven faute de données fiables et à jour. L’enrichissement automatisé traite ce problème à la source.
L’API Rodz expose trois endpoints d’enrichissement complémentaires. Chacun cible un type de données distinct : firmographique (identité et structure), financier (performances économiques et trajectoire de croissance) et SIRENE (registre légal français). Combinés, ils produisent un profil entreprise directement exploitable dans un CRM, un modèle de scoring ou un workflow de prospection.
Ce guide s’adresse aux développeurs, aux équipes RevOps et aux data analysts. Il suppose que vous maîtrisez les bases de l’API. Si ce n’est pas encore le cas, commencez par le guide de démarrage et d’authentification.
Prérequis
Avant de lancer vos premières requêtes, vérifiez que vous disposez de ces éléments :
- Un compte Rodz actif avec accès API activé. Créez-le sur app.rodz.io/register si nécessaire.
- Votre clé API (
API_KEY) récupérée depuis le dashboard Rodz. Le guide d’authentification détaille la procédure. - cURL installé sur votre machine. Il est préinstallé sur macOS et Linux. Sous Windows, Git Bash ou PowerShell font l’affaire (cURL est disponible nativement depuis Windows 10).
- Un identifiant entreprise : domaine, nom exact ou identifiant Rodz (
company_id). Chaque endpoint accepte ces trois modes. - (Optionnel) Un client API graphique comme Postman ou Insomnia pour tester interactivement.
- (Optionnel) Un numéro SIREN ou SIRET, si vous ciblez des entreprises françaises et souhaitez interroger l’endpoint SIRENE avec un identifiant direct.
Pour une référence complète des limites de débit, des codes d’erreur et de la pagination, consultez le guide de référence de l’API.
Endpoint 1 : Enrichissement firmographique (POST /enrich/firmographic)
Ce que cet endpoint renvoie
L’endpoint firmographique retourne les données d’identité et de structure d’une entreprise. Ce sont les informations de base pour segmenter, qualifier et scorer un compte en prospection B2B.
Les champs retournés incluent :
industry: secteur d’activité principal (ex. :software,manufacturing,healthcare)sub_industry: sous-secteur plus précis (ex. :cybersecurity,medtech)company_size: tranche d’effectifs (ex. :51-200,201-500)employee_count: nombre d’employés identifiésrevenue_range: tranche de chiffre d’affaires estimée (ex. :10M-50M EUR)headquarters: objet contenantcity,country,regionetpostal_codefounding_year: année de créationlinkedin_url: URL du profil LinkedIn de l’entreprisewebsite: domaine principaldescription: résumé de l’activité en une à deux phrases
Requête cURL
curl -X POST https://api.rodz.io/v1/enrich/firmographic \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "exemple-entreprise.fr"
}'Vous pouvez aussi identifier l’entreprise par son nom ou son identifiant Rodz :
curl -X POST https://api.rodz.io/v1/enrich/firmographic \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company_name": "Exemple Entreprise SAS",
"country": "FR"
}'Le paramètre country est recommandé avec company_name : il désambiguïse les entreprises portant des noms similaires dans des pays différents.
Exemple de réponse
{
"company_id": "comp_fr_9x4k2m",
"domain": "exemple-entreprise.fr",
"company_name": "Exemple Entreprise SAS",
"industry": "software",
"sub_industry": "marketing_automation",
"company_size": "51-200",
"employee_count": 87,
"revenue_range": "10M-50M EUR",
"headquarters": {
"city": "Lyon",
"region": "Auvergne-Rhône-Alpes",
"country": "FR",
"postal_code": "69002"
},
"founding_year": 2016,
"linkedin_url": "https://www.linkedin.com/company/exemple-entreprise",
"website": "https://exemple-entreprise.fr",
"description": "Exemple Entreprise développe une plateforme de marketing automation pour les PME françaises.",
"enriched_at": "2026-03-08T10:30:00Z",
"confidence_score": 0.94
}Le champ confidence_score (entre 0 et 1) indique le degré de fiabilité de la correspondance. Au-dessus de 0,85, l’identification est quasi certaine.
Cas d’usage
L’enrichissement firmographique entre dans plusieurs scénarios courants.
Segmentation CRM : taguer automatiquement vos comptes par secteur, taille et localisation pour affiner les listes de ciblage.
Lead scoring : attribuer des points selon la tranche d’effectifs ou le chiffre d’affaires. Une entreprise de 200 personnes dans votre secteur cible mérite plus d’attention qu’un artisan à deux salariés.
Nettoyage de base : identifier les doublons et les fiches incomplètes. Si vous maintenez une base de données de prospection performante, l’enrichissement firmographique est votre première couche de contrôle qualité.
Routage commercial : diriger automatiquement les leads vers le bon commercial selon la zone géographique ou le secteur.
Endpoint 2 : Enrichissement financier (POST /enrich/financial)
Ce que cet endpoint renvoie
L’endpoint financier fournit des données économiques plus précises qu’une simple tranche de chiffre d’affaires. Il s’adresse aux équipes qui veulent comprendre la trajectoire financière d’une entreprise, pas seulement sa taille aujourd’hui.
Les champs retournés incluent :
revenue: chiffre d’affaires estimé en euros (valeur numérique)revenue_currency: devise (EUR,USD, etc.)revenue_year: année de référencegrowth_rate: taux de croissance annuel en pourcentage (ex. :23.5)growth_period: période couverte (ex. :2024-2025)funding_total: montant total des financements levés depuis la créationfunding_currency: devise des financementslast_funding_date: date du dernier tour de tablelast_funding_amount: montant du dernier tourlast_funding_stage: stade du dernier financement (seed,series_a,series_b, etc.)employee_count_current: effectif actuelemployee_count_12m_ago: effectif il y a 12 moisemployee_growth_rate: variation de l’effectif sur 12 mois en pourcentage
Requête cURL
curl -X POST https://api.rodz.io/v1/enrich/financial \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "exemple-entreprise.fr"
}'Exemple de réponse
{
"company_id": "comp_fr_9x4k2m",
"domain": "exemple-entreprise.fr",
"company_name": "Exemple Entreprise SAS",
"revenue": 18500000,
"revenue_currency": "EUR",
"revenue_year": 2025,
"growth_rate": 23.5,
"growth_period": "2024-2025",
"funding_total": 12000000,
"funding_currency": "EUR",
"last_funding_date": "2025-06-15",
"last_funding_amount": 8000000,
"last_funding_stage": "series_a",
"employee_count_current": 87,
"employee_count_12m_ago": 62,
"employee_growth_rate": 40.3,
"enriched_at": "2026-03-08T10:30:00Z",
"confidence_score": 0.91
}Cas d’usage
Scoring avancé : intégrer le taux de croissance et l’évolution des effectifs dans votre modèle. Une entreprise qui croît de 40 % en un an est probablement en phase d’investissement actif, et c’est exactement le contexte dans lequel elle cherche de nouvelles solutions.
Priorisation pipeline : concentrer les efforts sur les entreprises dont le financement récent dépasse un seuil donné. Si le dernier tour date de moins de six mois, le budget est encore disponible.
Analyse de marché : agréger les données financières par secteur ou par région pour repérer les tendances. Quels segments affichent la plus forte croissance ? Où se concentrent les levées de fonds ?
Personnalisation des approches : mentionner le taux de croissance ou le dernier financement dans un message de prospection. L’accroche tient quand elle s’appuie sur des faits vérifiables.
Endpoint 3 : Registre français SIRENE (POST /enrich/french-sirene)
Ce que cet endpoint renvoie
L’endpoint SIRENE interroge le registre officiel des entreprises françaises (base SIRENE de l’INSEE) et renvoie les identifiants légaux et les informations administratives. Il est conçu pour les entreprises immatriculées en France.
Les champs retournés incluent :
siren: numéro SIREN à 9 chiffres (identifiant de l’entité juridique)siret: numéro SIRET à 14 chiffres (identifiant de l’établissement, SIREN + NIC)naf_code: code APE/NAF de l’activité principale (ex. :6201Zpour la programmation informatique)naf_label: libellé en clair du code NAFlegal_form: forme juridique (ex. :SAS,SARL,SA,EURL)legal_form_code: code officiel de la forme juridique (ex. :5710pour SAS)registration_date: date d’immatriculation au registreregistered_name: dénomination sociale officielleregistered_address: adresse du siège social (numéro, voie, code postal, commune)is_active: booléen indiquant si l’entreprise est toujours en activitéestablishment_count: nombre d’établissements actifs
Requête cURL
Vous pouvez interroger par domaine, par nom d’entreprise ou directement par numéro SIREN :
curl -X POST https://api.rodz.io/v1/enrich/french-sirene \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"siren": "832456789"
}'Ou par domaine :
curl -X POST https://api.rodz.io/v1/enrich/french-sirene \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"domain": "exemple-entreprise.fr"
}'Exemple de réponse
{
"company_id": "comp_fr_9x4k2m",
"domain": "exemple-entreprise.fr",
"siren": "832456789",
"siret": "83245678900015",
"registered_name": "EXEMPLE ENTREPRISE",
"legal_form": "SAS",
"legal_form_code": "5710",
"naf_code": "6201Z",
"naf_label": "Programmation informatique",
"registration_date": "2016-03-14",
"registered_address": {
"street_number": "42",
"street_name": "Rue de la République",
"postal_code": "69002",
"city": "Lyon"
},
"is_active": true,
"establishment_count": 3,
"enriched_at": "2026-03-08T10:30:00Z",
"confidence_score": 0.98
}Le score de confiance est généralement très élevé pour cet endpoint parce que la correspondance repose sur des identifiants officiels.
Cas d’usage
Conformité et vérification KYC : valider l’existence légale d’une entreprise avant de signer un contrat. Vérifier que le numéro SIREN est actif et que la forme juridique correspond à ce qui a été déclaré.
Enrichissement de bases françaises : compléter automatiquement les fiches CRM avec le code NAF, la forme juridique et l’adresse officielle du siège. Ces données sont souvent manquantes ou périmées dans les bases internes.
Segmentation par code NAF : le code APE est le standard français pour la classification sectorielle. Il permet un ciblage plus fin que les catégories génériques comme software ou manufacturing.
Détection d’entreprises inactives : nettoyer une base en identifiant les entreprises radiées ou en cessation d’activité via le champ is_active.
Tableau comparatif des trois endpoints
| Caractéristique | Firmographic | Financial | French SIRENE |
|---|---|---|---|
| Endpoint | POST /enrich/firmographic | POST /enrich/financial | POST /enrich/french-sirene |
| Couverture géographique | Mondiale | Mondiale | France uniquement |
| Identifiant requis | Domaine, nom ou company_id | Domaine, nom ou company_id | Domaine, nom, SIREN ou company_id |
| Données retournées | Secteur, taille, localisation, LinkedIn | CA, croissance, financement, effectifs | SIREN, SIRET, NAF, forme juridique |
| Niveau de détail financier | Tranche de CA (estimée) | CA exact, taux de croissance, historique | Aucun |
| Données légales | Non | Non | Oui (forme juridique, date immatriculation) |
| Score de confiance moyen | 0,85 - 0,95 | 0,80 - 0,95 | 0,95 - 0,99 |
| Cas d’usage principal | Segmentation, scoring, routage | Priorisation, analyse de marché | Conformité, enrichissement légal |
Quand combiner les trois endpoints
Pour un compte français, la combinaison la plus utile consiste à appeler les trois endpoints successivement. L’endpoint firmographique donne la vue d’ensemble (secteur, taille, localisation). L’endpoint financier ajoute la dimension économique (croissance, financement). L’endpoint SIRENE complète avec les identifiants légaux et la classification officielle.
Cette approche en trois couches sert particulièrement bien dans ces situations.
Le lead scoring multicritère : combiner la taille de l’entreprise (firmographique), son taux de croissance (financier) et son code NAF (SIRENE) dans un seul modèle.
La préparation de rendez-vous : présenter au commercial une fiche complète avant un appel, avec le chiffre d’affaires réel, l’historique de financement et la forme juridique.
L’audit de base de données : croiser les informations des trois sources pour détecter les incohérences : domaine qui ne correspond pas au SIREN, effectif déclaré qui diverge de la réalité.
Pour les entreprises hors de France, les deux premiers endpoints suffisent. L’endpoint SIRENE ne retourne pas de résultat pour une entreprise immatriculée à l’étranger.
Bonnes pratiques d’intégration
Gérer les limites de débit
Les endpoints d’enrichissement sont soumis aux limites de débit standard de l’API. Si vous enrichissez des lots importants (plus de 1 000 entreprises), espacez vos requêtes et mettez en place un mécanisme de retry avec backoff exponentiel. Une approche simple :
# Enrichissement par lot avec pause de 200ms entre chaque requête
for domain in $(cat domaines.txt); do
curl -s -X POST https://api.rodz.io/v1/enrich/firmographic \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d "{\"domain\": \"$domain\"}" >> resultats.json
sleep 0.2
doneMettre en cache les résultats
Les données firmographiques et SIRENE changent rarement. Mettez en cache les réponses pendant 30 jours pour éviter de consommer inutilement votre quota. Les données financières sont plus volatiles : un cache de 7 à 14 jours est plus adapté.
Gérer les résultats partiels
Il arrive qu’un endpoint renvoie une réponse avec certains champs à null. Une jeune startup peut ne pas encore avoir de chiffre d’affaires déclaré, par exemple. Votre code doit gérer ces cas sans rejeter l’ensemble de la fiche. Un enrichissement partiel reste plus utile qu’une fiche vide.
Questions fréquentes
Puis-je enrichir des entreprises hors de France avec l’endpoint SIRENE ?
Non. L’endpoint POST /enrich/french-sirene interroge exclusivement la base SIRENE de l’INSEE, qui ne couvre que les entreprises immatriculées en France. Pour les entreprises étrangères, utilisez les endpoints firmographique et financier, qui ont une couverture mondiale.
Combien de requêtes d’enrichissement mon plan inclut-il ?
Le quota dépend de votre abonnement Rodz. Les détails sont dans le dashboard sous Paramètres > API > Utilisation. Chaque appel à un endpoint d’enrichissement consomme un crédit. Appeler les trois endpoints pour une même entreprise consomme donc trois crédits.
Quelle est la différence entre revenue_range (firmographique) et revenue (financier) ?
Le champ revenue_range de l’endpoint firmographique est une estimation par tranche (ex. : 10M-50M EUR). Il repose sur des modèles prédictifs combinant la taille de l’entreprise, le secteur et des signaux publics. Le champ revenue de l’endpoint financier est une valeur numérique plus précise, calculée à partir de données déclarées ou de sources financières directes. Si la précision compte, prenez l’endpoint financier.
Comment identifier une entreprise si je n’ai que son nom ?
Passez le nom via le paramètre company_name et ajoutez country pour réduire l’ambiguïté. Si plusieurs entreprises correspondent, l’API retourne la correspondance la plus probable (score de confiance le plus élevé). Pour lever toute ambiguïté, le domaine ou l’identifiant Rodz (company_id) restent les options les plus fiables.
Les données SIRENE sont-elles à jour en temps réel ?
L’API Rodz synchronise les données SIRENE avec la base INSEE sur un cycle régulier. Le délai entre une modification au registre et sa disponibilité via l’API est généralement de quelques jours ouvrés. Pour les cas critiques (vérification avant signature de contrat), croisez avec une consultation directe sur sirene.fr.
Puis-je enrichir un lot de 10 000 entreprises d’un coup ?
L’API ne propose pas d’endpoint batch natif. Vous devez envoyer une requête par entreprise. Pour les volumes importants, utilisez un script avec gestion du débit (voir la section « Bonnes pratiques d’intégration » plus haut) ou contactez l’équipe Rodz pour discuter d’un enrichissement en lot via un canal dédié.
Comment savoir si une donnée est fiable ?
Chaque réponse inclut un champ confidence_score entre 0 et 1. Un score supérieur à 0,85 est considéré comme fiable. En dessous de 0,70, la correspondance est incertaine et une vérification manuelle est recommandée. L’endpoint SIRENE affiche les scores les plus élevés parce qu’il s’appuie sur des identifiants officiels.
Puis-je combiner l’enrichissement avec les signaux d’affaires Rodz ?
Oui, et c’est probablement la combinaison la plus intéressante. Rodz produit 108 signaux d’affaires différents en temps réel : dès qu’un signal d’affaires est détecté sur une entreprise (une levée de fonds, une campagne de recrutement, un déménagement), vous pouvez enrichir immédiatement le compte pour obtenir son profil complet. Ce qu’on veut faire, c’est contacter une entreprise quand elle traverse un contexte précis, pas un an après. L’enrichissement en temps réel transforme un signal en fiche prospect exploitable dans les 48 heures. Consultez la documentation complète de l’API pour voir comment orchestrer ces appels dans un workflow automatisé.