GET/v1/eu/recherche
- Prix
- 0,003 €
- Quota gratuit
- Inclus
- Famille
- Europe · recherche et fiches
| Paramètre | Où | Exemple |
|---|---|---|
q | requête · obligatoire | equinor |
pays | requête · facultatif | NO |
Ce qui est facturé
200Réponse signée Ed25519, débitée au prix de la route402Devis x402 signé, rien n'est débité4xxParamètre invalide ou requête trop large (requete_trop_large), jamais facturé5xxSource amont indisponible, jamais facturé
Voir l'exemple reconstitué (gratuit) Obtenir le devis de /v1/eu/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 européennes par nom dans les registres officiels. Copies locales, toutes lues sans filtre pays : Belgique, Chypre, Croatie, Espagne (base BORME, clé hoja), Estonie, Irlande, Lettonie, Lituanie, Norvège, Roumanie, Suède ; en direct, seulement avec le filtre pays : Finlande, Slovaquie, Suisse, Tchéquie ; la Pologne par GLEIF ; le Danemark et le Royaume-Uni s'ils sont activés ; plus GLEIF (LEI, monde). Les 10 meilleures : pays, identifiant national, statut, score_confiance, correspondance_nom (exacte, mots_entiers ou ressemblance du nom, null pour une requête par l'identifiant national du résultat ou sans nom servi). En Tchéquie et en Slovaquie, seules les personnes morales sont servies : un entrepreneur individuel (en Slovaquie, toute entité du registre des métiers, et celui du registre du commerce) ou une forme non reconnue comme personne morale est écarté, jamais nommé ; en Slovaquie, il est compté dans ecartes ; en Tchéquie, ARES n'est interrogé que sur les personnes morales : les autres ne sont ni lues ni comptées (ecartes_filtres_amont). En Estonie, personnes morales seulement : un entrepreneur individuel (FIE) ou une forme non reconnue. En Norvège, lue personnes morales d'abord : une entreprise individuelle (ENK), un particulier inscrit (PERS, TVAM), une masse (KBO, BO) ou une forme non reconnue, gardée dans la copie sans son nom, n'est ni rapprochée ni comptée : ecartes_non_mesures (LV, Lettonie ; NO, Norvège) le dit ; une succursale ou une entité étrangère (NUF, UTLA) dont la dénomination ne finit par aucune forme écrite de personne morale valable dans son pays d'origine selon le registre (suivie au plus de mots de succursale), ou que le registre inscrit entreprise individuelle dans son pays d'origine est écartée, comptée tant que la copie garde son nom (la collecte qui suit le lot I22 B n'en garde que le squelette, que la recherche ne rapproche plus). En Lettonie, personnes morales seulement : un commerçant individuel (IK), une entreprise individuelle, familiale, agricole ou de pêche, ou une forme non reconnue. En Croatie : un commerçant individuel (t.p.) ou une forme qui ne tranche pas. Au Danemark, par le CVR : ENK, PMV, succession (DØD) ou forme qui ne tranche pas. En Lituanie : une individuali įmonė (IĮ), sa succursale (individualios įmonės filialas) ou sa représentation (individualios įmonės atstovybė), ou une forme qui ne tranche pas. En Suède, lue personnes morales d'abord : une entreprise individuelle (enskild näringsverksamhet) ou une forme qui ne tranche pas. En Roumanie, lue de même : une forme qui ne tranche pas (succursale à forme non renseignée, autre forme). En Suisse, une entreprise individuelle (Einzelunternehmen, au nom du titulaire), une succursale (siège inconnu de la recherche) ou une forme qui ne tranche pas est écartée de même ; en Belgique, une entité sans forme juridique ou hors de la liste blanche ; en Finlande, en Irlande et au Royaume-Uni, une forme hors de la nomenclature du registre ; en Espagne, la hoja d'un entrepreneur individuel (acte empresario individual). Dans tous les pays, un LEI que GLEIF dit lui-même personne physique (catégorie SOLE_PROPRIETOR ou forme juridique d'entrepreneur individuel) est écarté de même, comme celui d'une forme juridique ambiguë, par doute, sa forme écrite en texte libre comprise ; celui d'un pays à copie locale n'est servi que si la copie le connaît et le sert. La catégorie SOLE_PROPRIETOR n'est pas même demandée à GLEIF : ces LEI ne sont pas lus, ecartes_filtres_amont le dit.
Identifiant attendu
Aucun : un nom d'au moins deux caractères, plus un filtre pays facultatif au format ISO à deux lettres.
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,003 €, 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
L'Allemagne et les Pays-Bas sont hors périmètre de cette recherche. La couverture par identifiant d'entité juridique donne les entités financières et les grands groupes, pas la petite société locale. En Tchéquie et en Slovaquie, seules les personnes morales sont servies : un entrepreneur individuel ou une forme non reconnue comme personne morale est écarté, jamais nommé ; en Slovaquie, il est compté dans ecartes ; en Tchéquie, le registre n'est interrogé que sur les personnes morales : les autres ne sont ni lues ni comptées, et la réponse le dit par ecartes_filtres_amont. En Estonie de même, seules les personnes morales sont servies : un entrepreneur individuel (FIE) ou une forme non reconnue comme personne morale est écarté et compté de la même façon. En Norvège aussi, seules les personnes morales sont servies, lues avant la coupe des candidats : une entreprise individuelle (ENK), un particulier inscrit, une masse portant un nom (KBO, BO) ou une forme non reconnue comme personne morale n'est gardée dans notre copie que sans son nom, et la recherche ne peut plus la rapprocher d'une requête : elle n'est ni servie ni comptée, et la réponse le dit par ecartes_non_mesures (LV, Lettonie ; NO, Norvège) ; une succursale ou une entité étrangère (NUF, UTLA) dont la dénomination ne finit par aucune forme écrite de personne morale valable dans son pays d'origine selon le registre (suivie au plus de mots de succursale), ou que le registre inscrit entreprise individuelle dans son pays d'origine est écartée, comptée tant que la copie garde son nom (la collecte qui suit le lot I22 B n'en garde que le squelette, que la recherche ne rapproche plus). En Lettonie de même, seules les personnes morales sont servies : un commerçant individuel (IK), une entreprise individuelle, familiale, agricole ou de pêche, ou une forme non reconnue comme personne morale n'est gardé dans notre copie que sans son nom, comme en Norvège. En Suisse, une entreprise individuelle (Einzelunternehmen), dont la raison de commerce porte le nom du titulaire, une succursale (la recherche ne connaît pas son siège) ou une forme qui ne tranche pas est écartée et comptée de la même façon. En Croatie aussi, seules les personnes morales sont servies : un commerçant individuel ou une forme qui ne tranche pas est écarté et compté de la même façon ; en Belgique, une entité sans forme juridique (entreprise personne physique), et en Espagne, la feuille d'un entrepreneur individuel (acte « empresario individual »), de même. Dans tous les pays, un identifiant d'entité juridique que GLEIF dit lui-même personne physique (entrepreneur individuel) est écarté de même, comme celui d'une forme qui ne dit pas si l'entité est une personne physique ou morale. La recherche ne demande pas même à GLEIF la catégorie des entrepreneurs individuels : ceux-là ne sont ni lus ni comptés, et la réponse le dit par ecartes_filtres_amont.
Routes voisines
/v1/eu/entreprise/{pays}/{id}: 0,01 €/v1/recherche: 0,002 €
Comment on paie
Chaque route se paie à l'appel, de deux façons, sans abonnement : en x402, en USDC ou EURC sur le réseau Base, sans compte ni clé d'API ; ou avec la clé d'API d'un compte, qui ouvre le quota gratuit. En x402, le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.
Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, dans la limite de 2 € de valeur, sur 122 routes sur 129 (la grille dit lesquelles), plus 100 lignes gratuites par mois sur l'identité en lot, et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.
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
# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
Routes utilisées et prix
| Route | Prix | Exemple | Ce qu'elle rend |
|---|---|---|---|
/v1/eu/recherche | 0,003 € | exemple gratuit | Recherche d'entreprises européennes par nom dans les registres officiels. Copies locales, toutes lues sans filtre pays : Belgique, Chypre, Croatie, Espagne (base BORME, clé hoja), Estonie, Irlande, Lettonie, Lituanie, Norvège, Roumanie, Suède ; en direct, seulement avec le filtre pays : Finlande, Slovaquie, Suisse, Tchéquie ; la Pologne par GLEIF ; le Danemark et le Royaume-Uni s'ils sont activés ; plus GLEIF (LEI, monde). Les 10 meilleures : pays, identifiant national, statut, score_confiance, correspondance_nom (exacte, mots_entiers ou ressemblance du nom, null pour une requête par l'identifiant national du résultat ou sans nom servi). En Tchéquie et en Slovaquie, seules les personnes morales sont servies : un entrepreneur individuel (en Slovaquie, toute entité du registre des métiers, et celui du registre du commerce) ou une forme non reconnue comme personne morale est écarté, jamais nommé ; en Slovaquie, il est compté dans ecartes ; en Tchéquie, ARES n'est interrogé que sur les personnes morales : les autres ne sont ni lues ni comptées (ecartes_filtres_amont). En Estonie, personnes morales seulement : un entrepreneur individuel (FIE) ou une forme non reconnue. En Norvège, lue personnes morales d'abord : une entreprise individuelle (ENK), un particulier inscrit (PERS, TVAM), une masse (KBO, BO) ou une forme non reconnue, gardée dans la copie sans son nom, n'est ni rapprochée ni comptée : ecartes_non_mesures (LV, Lettonie ; NO, Norvège) le dit ; une succursale ou une entité étrangère (NUF, UTLA) dont la dénomination ne finit par aucune forme écrite de personne morale valable dans son pays d'origine selon le registre (suivie au plus de mots de succursale), ou que le registre inscrit entreprise individuelle dans son pays d'origine est écartée, comptée tant que la copie garde son nom (la collecte qui suit le lot I22 B n'en garde que le squelette, que la recherche ne rapproche plus). En Lettonie, personnes morales seulement : un commerçant individuel (IK), une entreprise individuelle, familiale, agricole ou de pêche, ou une forme non reconnue. En Croatie : un commerçant individuel (t.p.) ou une forme qui ne tranche pas. Au Danemark, par le CVR : ENK, PMV, succession (DØD) ou forme qui ne tranche pas. En Lituanie : une individuali įmonė (IĮ), sa succursale (individualios įmonės filialas) ou sa représentation (individualios įmonės atstovybė), ou une forme qui ne tranche pas. En Suède, lue personnes morales d'abord : une entreprise individuelle (enskild näringsverksamhet) ou une forme qui ne tranche pas. En Roumanie, lue de même : une forme qui ne tranche pas (succursale à forme non renseignée, autre forme). En Suisse, une entreprise individuelle (Einzelunternehmen, au nom du titulaire), une succursale (siège inconnu de la recherche) ou une forme qui ne tranche pas est écartée de même ; en Belgique, une entité sans forme juridique ou hors de la liste blanche ; en Finlande, en Irlande et au Royaume-Uni, une forme hors de la nomenclature du registre ; en Espagne, la hoja d'un entrepreneur individuel (acte empresario individual). Dans tous les pays, un LEI que GLEIF dit lui-même personne physique (catégorie SOLE_PROPRIETOR ou forme juridique d'entrepreneur individuel) est écarté de même, comme celui d'une forme juridique ambiguë, par doute, sa forme écrite en texte libre comprise ; celui d'un pays à copie locale n'est servi que si la copie le connaît et le sert. La catégorie SOLE_PROPRIETOR n'est pas même demandée à GLEIF : ces LEI ne sont pas lus, ecartes_filtres_amont le dit. |
Passer à l'action
La première étape est gratuite et vous montre exactement ce que vous achèteriez, sans compte ni clé ; un compte, avec sa clé d'API, ouvre ensuite le quota gratuit.
Voir l'exemple reconstitué (gratuit) Obtenir le devis de /v1/eu/recherche Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur