Choisir une API de données d'entreprises : 8 critères

1. Les pays couverts, dans un format commun

Listez les pays de vos clients et fournisseurs, aujourd'hui et dans deux ans. Regardez ensuite si chaque pays a le même format de réponse : une API qui couvre plusieurs pays avec des formats différents vous oblige à écrire autant d'intégrations.

Companies couvre la France, la Belgique, la Suisse et le Royaume-Uni avec le même format. Chaque entreprise a un identifiant global, code pays et numéro national : FR-552100554, BE-0417497106, CH-101374515, GB-00445790. Les blocs qui n'existent pas dans un pays sont signalés comme non disponibles, sans erreur.

2. Les identifiants et leur validation

Une bonne API accepte les numéros tels que vos utilisateurs les saisissent (espaces, points, préfixes) et dit précisément ce qui ne va pas : format, clé de contrôle, entreprise introuvable, entreprise fermée, numéros qui ne concordent pas.

Companies accepte le SIREN, le SIRET, le numéro d'entreprise belge, le numéro IDE suisse, le company number britannique et les numéros de TVA français, belges et suisses. La route GET /v2/validate contrôle en un appel le format, l'existence, l'activité, la concordance des numéros et l'enregistrement du numéro de TVA, et détaille le résultat de chaque contrôle.

3. Des données à jour

Une fiche fausse coûte plus cher qu'une fiche absente : une adresse périmée, une entreprise fermée présentée comme active. Demandez comment la fraîcheur est rendue visible, et vérifiez sur quelques entreprises que vous connaissez bien.

Companies sert des données à jour, et la page État du service affiche publiquement l'état du service et des données. Chaque fiche indique le statut de l'entreprise (active, closed) et sa date de fermeture le cas échéant.

4. Le temps de réponse et les volumes

Dans un formulaire, une suggestion doit arriver pendant la frappe. Dans un traitement de masse, comptez le débit autorisé et la possibilité de grouper les appels.

Companies : l'autocomplétion répond en quelques millisecondes côté serveur ; la fiche de base pèse environ 0,5 Ko, et les blocs supplémentaires ne sont calculés que s'ils sont demandés. POST /v2/companies/batch lit jusqu'à 100 entreprises en un appel, et les en-têtes ETag évitent de relire une fiche inchangée. Le débit va de 100 requêtes par minute (Gratuit) à 1 000 (Standard) et 10 000 (Pro), sans quota mensuel.

5. L'engagement de disponibilité (SLA)

Distinguez un objectif d'un engagement : seul un SLA écrit, avec une définition de l'indisponibilité et des compensations, vous protège. Vérifiez aussi qu'une page d'état publique existe, avec l'historique des incidents.

Companies publie son accord de niveau de service : 99,9 % de disponibilité mensuelle garantie avec le forfait Pro, avec un avoir de 10 à 50 % de l'abonnement du mois si l'engagement n'est pas tenu ; le même objectif de 99,9 %, sans avoir, avec Standard ; un service au mieux avec le forfait gratuit. Une minute compte comme indisponible quand le service renvoie des erreurs serveur ou ne répond pas en 10 secondes. La page État du service montre l'état et l'historique des incidents.

6. Un prix lisible et un forfait gratuit

Un prix au crédit ou à la fiche consultée est difficile à prévoir quand l'usage grandit. Regardez ce qui se passe à dix fois votre volume actuel, et si un forfait gratuit permet de tester sans carte bancaire.

Companies a trois forfaits à prix fixe, publiés sur la page des tarifs : Gratuit à 0 €, Standard à 19 € HT par mois, Pro à 129 € HT par mois, avec 20 % de remise à l'année. Aucun forfait n'a de quota mensuel : les limites portent sur le débit par minute. Le forfait gratuit, sans carte bancaire, donne accès à toutes les routes.

7. La documentation, les tests et les erreurs

Ouvrez la documentation avant de signer : chaque route doit avoir ses paramètres, un exemple de requête et de réponse, et la liste de ses erreurs. Des codes d'erreur stables et un outil pour tester sans coder font gagner des jours d'intégration.

Companies documente chaque route avec ses paramètres, un exemple et ses erreurs, et fournit une spécification OpenAPI. La démo de la page d'accueil interroge l'API sans compte ; le Testeur de l'espace client envoie n'importe quelle requête avec votre compte. Toutes les erreurs ont le même format, avec un code stable (invalid_identifier, rate_limit_exceeded…) et un lien vers la documentation ; les en-têtes X-RateLimit-Remaining et Retry-After indiquent le débit restant et le délai d'attente.

8. Le RGPD et l'hébergement en Europe

Demandez où les données transitent et sont stockées, ce qui est conservé de vos requêtes, et qui sont les sous-traitants. Pour un éditeur européen, c'est souvent une exigence de vos propres clients.

Companies est édité par une société française. L'API tourne sur un serveur situé en France, et la base des comptes est hébergée dans l'Union européenne, à Francfort. Le journal des requêtes conserve la date, le chemin, le statut et la durée, jamais le contenu des réponses. Pour l'enrichissement d'un fichier, seule la colonne des identifiants quitte votre ordinateur. La politique de confidentialité liste les traitements, les durées de conservation et les sous-traitants.

En plus : la surveillance des changements

Vérifier une entreprise le jour de son inscription ne suffit pas : elle peut fermer, déménager ou entrer en procédure collective. Une API qui prévient des changements évite de relire régulièrement toutes vos fiches.

Companies inclut la surveillance dans tous les forfaits : 2 entreprises avec le compte gratuit, 1 000 avec Standard, 10 000 avec Pro. Chaque changement (statut, nom, adresse, activité, signal de procédure collective, annonce légale, sanctions) devient un événement, envoyé sur un webhook signé et par e-mail, et lisible avec GET /v2/events pendant 90 jours. L'article Comment savoir si une entreprise est en liquidation judiciaire montre un cas d'usage.

Faire le test en un appel

Le plus simple pour comparer est de lancer la même requête sur une entreprise que vous connaissez. Avec Companies, une fiche belge avec son adresse, son numéro de TVA et ses signaux :

curl "https://companies.jsonpage.com/v2/companies/BE-0417497106?include=address,vat,signals" \
  -H "X-API-Key: $COMPANIES_API_KEY"

Créez un compte gratuit pour obtenir votre clé, puis reprenez la grille ci-dessus sur vos propres cas. Les réponses aux questions sur les forfaits et la disponibilité sont dans la FAQ.

Pour aller plus loin

• SIRENNuméro SIREN : à quoi il sert et comment le trouverLe format à 9 chiffres, qui en reçoit un, où il apparaît et comment trouver celui d'une entreprise à partir de son nom.
• TVANuméro de TVA intracommunautaire : format et vérificationLes formats français, belge et suisse, les mentions sur la facture et la vérification avant de facturer.
• PROCÉDURES COLLECTIVESComment savoir si une entreprise est en liquidation judiciaireLiquidation, redressement et sauvegarde expliqués, les signaux à suivre et les alertes sur vos clients et fournisseurs.