Quand utiliser cette API ?
Les cas d’usage et limites sont publiés avec l’API pour faciliter une intégration correcte par un humain comme par un agent.
À utiliser quand
- Vous avez besoin du chiffre d’affaires ou du résultat net publics disponibles pour une entreprise française.
- Vous souhaitez un historique financier normalisé sur plusieurs années avec calculs simples de croissance du chiffre d’affaires et de marge nette lorsque les données existent.
À éviter quand
- Vous recherchez des comptes de gestion en temps réel, des données bancaires, une valorisation d’entreprise ou un score de crédit.
- Vous avez seulement besoin de l’identité ou du statut administratif ; utilisez company/fr/profile ou company/fr/verify.
Limitations
- Les exercices financiers ne sont retournés que lorsque la source publique d’entreprises expose des données financières déposées.
- Des comptes absents ou confidentiels peuvent rendre l’historique incomplet ; ce service ne constitue ni une évaluation de crédit ni une opinion d’audit.
Sources et provenance
Les sources publiées pour cet endpoint sont affichées directement avec leur lien d’origine.
API Recherche d'entreprises
recherche-entreprises.api.gouv.fr
Réponse réelle stockée
Ce snapshot est servi depuis les données publiées en BDD sans exécuter l’API payante.
Requête
{
"identifier": "356000000"
}Réponse stockée
{
"identifier": "356000000",
"identifier_type": "siren",
"exists": true,
"siren": "356000000",
"name": "LA POSTE",
"summary": {
"years_available": 1,
"latest_year": "2024",
"latest_revenue": 34569000000,
"latest_net_income": 1722000000,
"latest_revenue_growth_percent": null,
"latest_net_margin_percent": 4.98
},
"financials": [
{
"year": "2024",
"revenue": 34569000000,
"net_income": 1722000000,
"revenue_growth_percent": null,
"net_margin_percent": 4.98
}
]
}Politique de facturation
0.010 $ / appel · facturation sur résultat valide · résultat vide non facturé · erreur non facturée.
Schémas Input / Output
Contrats simplifiés de l’endpoint. Le schéma complet reste disponible dans OpenAPI 3.1.
Input schema
identifierstringObligatoire · SIREN à 9 chiffres ou SIRET à 14 chiffresVoir le JSON Schema complet
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"pattern": "^[0-9]{9}([0-9]{5})?$",
"description": "SIREN à 9 chiffres ou SIRET à 14 chiffres"
}
},
"required": [
"identifier"
],
"additionalProperties": false
}Output schema
identifierstringObligatoireidentifier_typestringObligatoireexistsbooleanObligatoiresirenstring | nullObligatoirenamestring | nullObligatoiresummaryobjectObligatoirefinancialsarrayObligatoireVoir le JSON Schema complet
{
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"identifier_type": {
"type": "string",
"enum": [
"siren",
"siret"
]
},
"exists": {
"type": "boolean"
},
"siren": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"summary": {
"type": "object",
"properties": {
"years_available": {
"type": "integer"
},
"latest_year": {
"type": [
"string",
"null"
]
},
"latest_revenue": {
"type": [
"number",
"null"
]
},
"latest_net_income": {
"type": [
"number",
"null"
]
},
"latest_revenue_growth_percent": {
"type": [
"number",
"null"
]
},
"latest_net_margin_percent": {
"type": [
"number",
"null"
]
}
},
"required": [
"years_available",
"latest_year",
"latest_revenue",
"latest_net_income",
"latest_revenue_growth_percent",
"latest_net_margin_percent"
],
"additionalProperties": false
},
"financials": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "string"
},
"revenue": {
"type": [
"number",
"null"
]
},
"net_income": {
"type": [
"number",
"null"
]
},
"revenue_growth_percent": {
"type": [
"number",
"null"
]
},
"net_margin_percent": {
"type": [
"number",
"null"
]
}
},
"required": [
"year",
"revenue",
"net_income",
"revenue_growth_percent",
"net_margin_percent"
],
"additionalProperties": false
}
}
},
"required": [
"identifier",
"identifier_type",
"exists",
"siren",
"name",
"summary",
"financials"
],
"additionalProperties": false
}Exemples de requêtes
Formulations publiées avec l’API pour aider à sélectionner le bon endpoint.
Quel est le dernier chiffre d’affaires disponible du SIREN 356000000 ?
Montre-moi l’évolution publique du chiffre d’affaires de cette entreprise.
Quel est son dernier résultat net public et sa marge nette ?