# Building a B2B prospecting list

A purchased prospect list ages the moment it is exported. Built on the official registry, it is fresh by definition. /v1/prospection filters the whole registry — 29,922,486 company numbers, 16,638,954 active — and returns 100 active companies per page, one payment per page.

## Available criteria

- NAF/APE activity code, at any level of the classification.
- Department or postcode prefix.
- Legal form.
- Workforce bracket.
- Company age — to target young structures or, conversely, established ones.
- Active environmental-renovation certification.
- Gender-equality index declared.

> Pricing is **per page of 100 companies**. A well-filtered list therefore costs a few cents; a badly filtered one costs the price of pagination. Tighten the criteria before paging.

## Resolving a name to an identifier, for almost nothing

`/v1/recherche` is the cheapest route in the catalogue. It returns the top 10 matches with identity, company number, activity code, town, active-or-ceased status, and a **confidence score** from 0 to 1 that disambiguates namesakes. It is the entry point to use before any more expensive call.

If your need is only to resolve a name to an identifier, be aware that a free public API does that too — we say so on our dedicated comparison page. Paying makes sense once you chain into the data that API does not serve.

## Searching by director

`/v1/dirigeant/recherche` does the reverse: from a surname, it lists the French companies where a person of that name holds or held an office, with the company number, name and role. Useful to map a network, or to look into a director before entering a relationship.

> ⚠️ Results are **indicative**: namesakes are not disambiguated and very common surnames are capped. Person data is limited to surname, first names, role and birth **year** — in line with the rules applying to registry data. Do not base a decision on a name match alone.

## What we do not sell, and why

No e-mail addresses, no phone numbers, no named contacts. This is not a coverage gap: that data is not in the official registries, it is collected elsewhere, and reselling it raises lawfulness questions we do not want to carry. Our list gives you qualified **companies**; making contact stays your job.

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# 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 used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/prospection` | $0.02 | French B2B prospecting and lead generation over the full official French company registry (29.8M companies): build targeted company lists with multi-criteria filters — NAF/APE activity code, departement or postal-code prefix, legal form, workforce bracket, company age, active RGE environmental certification, gender-equality index. Returns 100 active companies per page; each page is one payment. Combine filters to narrow a market segment into fresh, registry-grade company lists for France. |
| `/v1/recherche` | $0.001 | French company search and company lookup by name or SIREN in the official French company registry (INSEE Sirene / INPI RNE open data). Name search returns the top 10 matches with identity, SIREN, NAF code, city and active/ceased status, plus a score_confiance (0-1 match confidence) that helps disambiguate homonyms. The entry point to official data and company data on France: resolve a trading name to its SIREN identifier before pulling the full company profile, filings or financials. |
| `/v1/dirigeant/recherche` | $0.02 | Reverse search for company directors and officers in France: a people search by surname (?nom=) that lists the French companies where a person of that name holds or held an office, with each company SIREN, name and the person role — network mapping and due diligence on directors. Person data is limited to surname, first names, role and birth YEAR (French GDPR/INPI rules). Results are indicative: homonyms are not disambiguated and very common names are capped. |
| `/v1/secteur/{code_naf}/benchmarks` | $0.05 | Sector benchmarks and sector statistics for a French NAF activity code (any level: division, groupe, classe, sous-classe): number of active companies, median company age (with quartiles), workforce-bracket distribution, and — when at least 5 companies file public accounts — median revenue, EBITDA margin, pre-tax result and debt ratio. Peer comparison in one call: place a company against its peers. Aggregates only, no personal data; sectors with fewer than 5 companies are excluded. |

> ⚠️ Director search returns indicative results: namesakes are not disambiguated and very common surnames are capped.

## Frequently asked questions

### Are ceased companies included?

No, prospecting returns active companies only. For historical work, use the search route, which returns the status.

### Can I export a whole sector?

Technically yes, by paging, and each page is a payment. Look at the sector statistics first: they will tell you how many companies it contains, and therefore what the export would cost, before you start.

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/prospection.json)
- [Get the quote for /v1/prospection](https://api.sirenic.eu/v1/prospection)
- [Read the route reference](https://api.sirenic.eu/en/api)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Anticipating public-contract expiries](https://api.sirenic.eu/en/use-cases/anticipate-public-contract-expiries-before-notice)
- [Comparing companies on official data](https://api.sirenic.eu/en/use-cases/compare-2-5-companies-per-axis-rankings-no-overall-winner)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/