sirenic

France · identité, documents

Compter les entreprises par critères croisés

Le premier appel d'un agent qui construit une liste : compter avant de lister. Le compte est exact, sur la même grammaire que la route de liste, et chaque source est datée dans la réponse : une liste de dix mille sociétés se resserre avant d'être payée page à page.

https://api.sirenic.eu/v1OpenAPI 3.1llms.txt

GET/v1/entreprises/requete/compter

Prix
0,002 €
Quota gratuit
Inclus
Famille
France · identité, documents
Paramètres
ParamètreOùExemple
criteresrequête · facultatif[{"champ":"siege.departement","op":"=","valeur":"69"},{"champ":"finances.ca","op":">","valeur":1000000}]
trirequête · facultatifsans exemple
pagerequête · facultatifsans exemple
champsrequête · facultatifsans exemple

Ce qui est facturé

  • 200Réponse signée Ed25519, débitée au prix de la route
  • 402Devis 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/entreprises/requete/compter

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) :

Comptez les entreprises françaises qui répondent à des critères croisés librement sur une table pré-croisée des registres officiels : géographie (département, région, préfixe de code postal), activité NAF, forme juridique, effectif, ancienneté, derniers comptes déposés (chiffre d'affaires, résultat net, marges, ratios, tendances, trésorerie) et signaux publics (RGE, index égalité, ICPE et Seveso, marchés publics, agréments). Personnes morales actives par défaut. Renvoie le compte exact et la date de chaque source : mesurez un marché avant de le lister.

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

Personnes morales actives par défaut (un critère sur identite.etat compte aussi les sociétés cessées), aucun dirigeant ni aucune personne en critère : les entrepreneurs individuels ne sont jamais comptés. Un critère financier ne retient que les sociétés qui publient des comptes exploitables.

Routes voisines

  • /v1/entreprises/requete/lister — 0,02 €
  • /v1/prospection — 0,02 €
  • /v1/secteur/{code_naf}/benchmarks — 0,05 €

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

RoutePrixExempleCe qu'elle rend
/v1/entreprises/requete/compter0,002 €exemple gratuitComptez les entreprises françaises qui répondent à des critères croisés librement sur une table pré-croisée des registres officiels : géographie (département, région, préfixe de code postal), activité NAF, forme juridique, effectif, ancienneté, derniers comptes déposés (chiffre d'affaires, résultat net, marges, ratios, tendances, trésorerie) et signaux publics (RGE, index égalité, ICPE et Seveso, marchés publics, agréments). Personnes morales actives par défaut. Renvoie le compte exact et la date de chaque source : mesurez un marché avant de le lister.

Questions fréquentes

Quels champs puis-je croiser ?

Les champs filtrables du catalogue : identite.siren, identite.personne_morale, identite.forme, identite.naf, identite.categorie_entreprise, identite.tranche_effectifs, identite.date_creation, identite.age, identite.etat, identite.ess, identite.societe_mission, siege.code_postal, siege.code_commune, siege.departement, siege.region, finances.date_cloture, finances.type_bilan, finances.fiabilite, finances.nb_exercices, finances.ca, finances.marge_brute, finances.ebe, finances.ebit, finances.resultat_net, finances.taux_endettement, finances.autonomie_financiere, finances.ratio_liquidite, finances.caf_sur_ca, finances.capacite_remboursement, finances.marge_ebe, finances.rcai_sur_ca, finances.couverture_interets, finances.bfr_sur_ca, tendances.variation_ca_1an, tendances.variation_ca_3ans, tendances.variation_rn_1an, tendances.variation_bfr_sur_ca_3ans, tresorerie.disponibilites, tresorerie.dettes_moins_1an, tresorerie.dettes_fiscales_sociales, tresorerie.dettes_total, signaux.rge_actif, signaux.egapro_note, signaux.egapro_annee, signaux.icpe_nb, signaux.icpe_seveso, signaux.marches_nb, signaux.marches_montant, signaux.marches_dernier, signaux.agrements. Jusqu'à 20 conditions combinées par ET ; le OU passe par l'opérateur in. GET /v1/lecture (gratuit) donne pour chacun son type, ses opérateurs, son unité, sa source et ce qu'il veut dire.

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/entreprises/requete/compter Être prévenu des packs en euros

OpenAPI · llms.txt · Catalogue complet des routes et prix