GET/v1/recherche
- Prix
- 0,002 €
- Quota gratuit
- Inclus
- Famille
- France · identité, documents
| Paramètre | Où | Exemple |
|---|---|---|
q | requête · obligatoire | danone |
Ce qui est facturé
200Réponse signée Ed25519, débitée au prix de la route402Devis x402 signé, rien n'est débité4xxIdentifiant inconnu ou invalide, jamais facturé5xxSource amont indisponible, jamais facturé
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/recherche
Ce que la route rend
Description publiée au catalogue, traduite ici en français (les agents la lisent en anglais, comme toutes nos surfaces de découverte) :
Recherche d'entreprises françaises et consultation d'une société par nom ou par SIREN dans le registre officiel des entreprises françaises (données ouvertes INSEE Sirene / INPI RNE). La recherche par nom renvoie les 10 meilleures correspondances avec l'identité, le SIREN, le code NAF, la ville et le statut actif/cessé, ainsi qu'un score_confiance (0-1, confiance de la correspondance) qui aide à départager les homonymes. Le point d'entrée vers les données officielles et les données d'entreprises sur la France : résoudre un nom commercial en identifiant SIREN avant d'aller chercher la fiche complète, les dépôts ou les comptes.
Identifiant attendu
Aucun identifiant : un paramètre de requête textuel. Un SIREN, un SIRET ou un numéro de TVA français est aussi accepté — espacé ou précédé de son intitulé (« SIREN : 552 032 534 ») — et rend directement la société correspondante.
Un identifiant au mauvais format dans le chemin rend 400 et n'est pas facturé — mais il vous fait perdre un aller-retour. C'est la première cause d'appel raté sur les routes étrangères. Un paramètre de recherche, lui, est nettoyé : les caractères non pris en charge sont retirés et la requête utile est servie.
Prix et facturation
Tarif : 0,002 €, débité en crédits (1 crédit = 1 €) ; en x402, le même montant se règle en USDC ou en EURC. Le montant qui fait foi est celui du devis 402 renvoyé par la route elle-même, pas ce texte, qui est dérivé de la même grille mais reste une page.
Une réponse d'erreur annule le paiement : un 400, un 404 ou un 503 n'est jamais facturé. Une panne d'une source amont ferme la route en 503 plutôt que de servir une réponse dégradée.
Ce que cette route ne fait pas
Si votre seul besoin est de résoudre un nom en identifiant, une API publique gratuite le fait aussi bien — nous le disons sur notre comparatif. Payez cette route quand vous enchaînez, dans la même transaction, sur ce que cette API gratuite ne sert pas.
Routes voisines
/v1/entreprise/{siren}— 0,005 €/v1/prospection— 0,02 €/v1/dirigeant/recherche— 0,02 €
Comment on paie
Chaque route se paie à l'appel, en USDC ou EURC sur le réseau Base, par le protocole x402 : pas de compte à créer, pas de clé d'API, pas d'abonnement. Le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.
Vous préférez une facture en euros et des crédits prépayés ? C'est en préparation et nous n'annonçons pas de date tant que ce n'est pas ouvert. Écrivez à contact@sirenic.eu et vous serez prévenu à l'ouverture.
Les réponses payantes sont signées Ed25519 : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans l'OpenAPI et le llms.txt.
Un appel, de bout en bout
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534
# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
Routes utilisées et prix
| Route | Prix | Exemple | Ce qu'elle rend |
|---|---|---|---|
/v1/recherche | 0,002 € | exemple gratuit | Recherche d'entreprises françaises et consultation d'une société par nom ou par SIREN dans le registre officiel des entreprises françaises (données ouvertes INSEE Sirene / INPI RNE). La recherche par nom renvoie les 10 meilleures correspondances avec l'identité, le SIREN, le code NAF, la ville et le statut actif/cessé, ainsi qu'un score_confiance (0-1, confiance de la correspondance) qui aide à départager les homonymes. Le point d'entrée vers les données officielles et les données d'entreprises sur la France : résoudre un nom commercial en identifiant SIREN avant d'aller chercher la fiche complète, les dépôts ou les comptes. |
Passer à l'action
Aucun compte à créer, aucune clé à demander : la première étape est gratuite et vous montre exactement ce que vous achèteriez.
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/recherche Être prévenu des packs en euros