# Trouver les sosies de ses meilleurs clients

Donnez vos meilleurs clients, recevez leurs sosies : le profil est déduit des registres officiels et servi tel quel, sous la forme des critères de la route de liste, pour lire les pages suivantes vous-même. Sous 50 résultats, il s'élargit d'un cran à la fois et chaque cran est dit ; la zone que vous donnez ne s'élargit jamais.

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

**Trouvez des entreprises françaises qui ressemblent à vos meilleurs clients : donnez de 2 à 5 SIREN de clients (?exemples=), une région ou un département si vous voulez, et recevez la première page de 100 personnes morales actives qui répondent au profil déduit (codes NAF, tranches d'effectif, formes juridiques, dates de création, zone), clients exclus, avec le total exact. Sous 50 résultats, le profil s'élargit d'un cran à la fois, chaque cran dit ; il est servi en critères pour lire les pages suivantes.**

## Identifiant attendu

exemples : de 2 à 5 SIREN distincts (9 chiffres, clé de Luhn juste), séparés par des virgules ; region ou departement en option, l'un ou l'autre.

> ⚠️ 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.

## Extrait d'une réponse rendue sur des données de test

Photo datée du 08/10/2026, rendue par la route sur des données de test (entreprises fictives), sans achat, tronquée à un élément par tableau puis coupée en longueur. Ce n'est pas une donnée en direct. L'extrait complet est servi **gratuitement** par [la surface d'exemples](https://api.sirenic.eu/exemples/prospection-sosies.json), et le schéma par l'OpenAPI.

```
{
 "profil": {
  "exemples_retenus": 2,
  "criteres": [
   {
    "champ": "identite.naf",
    "op": "in",
    "valeur": [
     "25.62B"
    ]
   },
   {
    "champ": "identite.tranche_effectifs",
    "op": "in",
    "valeur": [
     "11",
     "12"
    ]
   },
   {
    "champ": "identite.forme",
    "op": "in",
    "valeur": [
     "5710"
    ]
   },
   {
    "champ": "identite.date_creation",
    "op": "entre",
    "valeur": [
     "2010-05-10",
     "2018-09-20"
    ]
   },
   {
    "champ": "siege.departement",
    "op": "=",
    "valeur": "38"
   },
   {
    "champ": "identite.siren",
    "op": "hors",
    "valeur": [
     "000000018",
     "000000026"
    ]
   }
  ],
  "ecarts": [],
  "elargissements": []
 },
 "page": 1,
 "page_suivante": true,
 "nombre_resultats": 100,
 "resultats": [
  {
   "identite": {
    "siren": "000000034",
    "denomination": "SOCIETE FICTIVE SOSIE 3",
    "forme": "5710",
    "naf": "25.62B",
    "tranche_effectifs": "11",
    "etat": "A",
    "date_creation": "2011-04-04"
   },
   "siege": {
    "code_postal": "38000",
    "commune": "COMMUNE FICTIVE 38185",
    "departement": "38"
   },
   "finances": {
    "date_cloture": null,
    "ca": null,
    "resultat_net": null
   }
  }
 ],
 "listes_bornees": {
  "resultats": {
   "nombre_total": 102,
   "tronque": true
  }
 },
 "disclaimer": "Profil déduit des exemples, relu par /v1/entreprises/requete/lister pour les pages suivantes ; élargi d'un cran à la fois sous 50 résultats, chaque cran dit ; exemples exclus ; sans classement par ressemblance. / Profile deduced from the examples, read again b
…
```

## Prix et facturation

Tarif : **0,02 €**, 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.

## Appeler la route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i "https://api.sirenic.eu/v1/prospection/sosies?exemples=000000018,000000026"

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch "https://api.sirenic.eu/v1/prospection/sosies?exemples=000000018,000000026"

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
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
```

## Ce que cette route ne fait pas

Chaque résultat répond au profil, sans classement par ressemblance. Un exemple introuvable, qui n'est pas une personne morale diffusible ou cessé est écarté et dit par son rang ; aucun entrepreneur individuel dans le profil ni dans les résultats. Personnes morales actives par défaut.

## Routes voisines

- `/v1/entreprises/requete/lister` — 0,02 €
- `/v1/entreprises/requete/compter` — 0,002 €
- `/v1/prospection` — 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é.

Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, sur 109 routes sur 125 (la grille dit lesquelles), 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](https://api.sirenic.eu/openapi.json) et le [llms.txt](https://api.sirenic.eu/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/prospection/sosies` | 0,02 € | [exemple gratuit](https://api.sirenic.eu/exemples/prospection-sosies.json) | Trouvez des entreprises françaises qui ressemblent à vos meilleurs clients : donnez de 2 à 5 SIREN de clients (?exemples=), une région ou un département si vous voulez, et recevez la première page de 100 personnes morales actives qui répondent au profil déduit (codes NAF, tranches d'effectif, formes juridiques, dates de création, zone), clients exclus, avec le total exact. Sous 50 résultats, le profil s'élargit d'un cran à la fois, chaque cran dit ; il est servi en critères pour lire les pages suivantes. |

## Passer à l'action

- [Voir une réponse sur données de test (gratuit)](https://api.sirenic.eu/exemples/prospection-sosies.json)
- [Obtenir le devis de /v1/prospection/sosies](https://api.sirenic.eu/v1/prospection/sosies?exemples=000000018,000000026)
- [Créer un compte : 150 appels gratuits par mois](https://api.sirenic.eu/compte?utm_source=recherche&utm_campaign=referencement)

## À lire ensuite

- [Trouvez des prospects qui ressemblent à vos meilleurs clients](https://api.sirenic.eu/cas-usage/trouvez-prospects-qui-ressemblent-vos-meilleurs-clients)
- [Construire une liste de prospection B2B](https://api.sirenic.eu/cas-usage/construire-liste-prospection-b2b-france)


---

[Accueil](https://api.sirenic.eu/) · [Offres](https://api.sirenic.eu/offres) · [Articles](https://api.sirenic.eu/articles) · [Routes](https://api.sirenic.eu/api) · [À propos](https://api.sirenic.eu/a-propos) · [Mentions légales](https://api.sirenic.eu/mentions-legales) · [Confidentialité](https://api.sirenic.eu/confidentialite)