Comprendre la source
D'où viennent les données ?+
Les fiches proviennent du répertoire Sirene diffusé par l'Insee en données ouvertes. Siren utilise un stock synchronisé pour répondre rapidement aux recherches exactes par SIREN ou SIRET.
À quelle fréquence les données sont-elles mises à jour ?+
Le stock Sirene est synchronisé avec les changements publiés par l'Insee. La date des données servies est indiquée par /v1/metadata.
Que signifie le statut de diffusion « P » ?+
Il indique une diffusion partielle. Les noms et adresses protégés sont masqués dans les réponses de l'API. Ces données ne doivent pas être utilisées pour la prospection.
Pourquoi une recherche peut-elle renvoyer « introuvable » ?+
Le numéro peut être erroné, absent du répertoire ou pas encore présent dans le stock synchronisé. L'API renvoie alors une réponse 404.
Intégrer le service
Comment s'authentifier ?+
Chaque appel aux routes de consultation transmet une clé dans l'en-tête X-API-Key. Vous créez et gérez vos clés depuis votre compte Siren.
Quelle est la différence entre SIREN et SIRET ?+
Le SIREN comporte 9 chiffres et identifie une entreprise. Le SIRET comporte 14 chiffres et identifie un établissement de cette entreprise.
Que se passe-t-il si je dépasse le débit prévu ?+
L'API répond avec le code 429 et l'en-tête Retry-After. Le client peut attendre puis réessayer. Les limites sont de 100 requêtes par minute en Gratuit et 1 000 en Standard.
Peut-on utiliser l'API depuis un navigateur ?+
Pour protéger votre clé, appelez l'API depuis votre serveur. Ne placez pas une clé privée dans du JavaScript livré aux visiteurs d'un site.
Choisir son rythme
Y a-t-il un quota mensuel ?+
Non. Les forfaits fixent un débit par minute, sans plafond mensuel de requêtes.
Que signifie « illimité » pour le forfait Pro ?+
Le forfait Pro n'a pas de plafond de débit propre au forfait. Les protections générales de disponibilité et contre les abus continuent de s'appliquer.
Existe-t-il un SLA ?+
Un objectif indicatif de disponibilité de 99,9 % par mois est affiché pour les forfaits payants. Il n'est pas garanti sur l'infrastructure actuelle à serveur unique. Consultez la page SLA pour la méthode de mesure proposée.
Comment accéder à Siren ?+
Le service est accessible sur https://siren.jsonpage.com. Créez un compte pour obtenir une clé API ; les abonnements payants sont traités par Stripe.