sirenic

France · identity, documents

A company's hiring signals

A company that hires is a company on the move: the freshest activity signal there is, months ahead of any filing. Served as aggregated signals derived from the France Travail snapshot - never posting texts or contacts - with the method and its limits stated in the response.

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

GET/v1/entreprise/{siren}/emploi

Price
$0.02
Free quota
No
Family
France · identity, documents
Parameters
ParameterWhereExample
sirenpath · required095580841

What is charged

  • 200Ed25519-signed response, charged at the route's price
  • 402Signed x402 quote, nothing is debited
  • 4xxUnknown or invalid identifier, never charged
  • 5xxUpstream source unavailable, or a counted total below the list read (compte_incoherent), never charged

See a real response (free) Get the quote for /v1/entreprise/{siren}/emploi

What the route returns

Catalogue description, exactly as agents read it:

Hiring signals for a French company, derived on demand from France Travail data (snapshot under 24 h, nothing stored): actively-hiring yes/no/unprovable, active-postings count (SIREN-keyed employer page when available, else strict name matching over known locations), top ROME occupation families, contract-type mix, share of postings displaying a pay amount - plus the Egapro gender-equality index and the INSEE workforce bracket. Aggregated signals only, never posting texts or recruiter contacts.

Expected identifier

9-digit company number.

A wrongly formatted identifier in the path returns 400 and is not billed — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes. A search parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

Price and billing

Price: $0.02. The authoritative amount is the one in the 402 quote returned by the route itself, not this text, which derives from the same grid but is still just a page.

An error response cancels the payment: a 400, 404 or 503 is never billed. An upstream outage closes the route with a 503 rather than serving a degraded response.

What this route does not do

This is not a job-postings feed nor an application tool: no posting is resold, no recruiter contact is served. Counting relies on the France Travail employer page when one exists; otherwise strict matching on company and store names - postings via temp agencies or recruiting firms are then not counted, and absence is never asserted without an employer page.

Neighbouring routes

  • /v1/entreprise/{siren}/etablissements: $0.003
  • /v1/intelligence/{siren}: $1.00

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.

Open today: 150 free calls a month with an account, on 106 of 122 routes (the price list says which), and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

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 and in llms.txt.

One call, end to end

# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes used and pricing

RoutePriceSampleWhat it returns
/v1/entreprise/{siren}/emploi$0.02free sampleHiring signals for a French company, derived on demand from France Travail data (snapshot under 24 h, nothing stored): actively-hiring yes/no/unprovable, active-postings count (SIREN-keyed employer page when available, else strict name matching over known locations), top ROME occupation families, contract-type mix, share of postings displaying a pay amount - plus the Egapro gender-equality index and the INSEE workforce bracket. Aggregated signals only, never posting texts or recruiter contacts.

Take it further

No account to create, no key to request: the first step is free and shows you exactly what you would be buying.

See a real response (free) Get the quote for /v1/entreprise/{siren}/emploi Create an account: 150 free calls a month

OpenAPI · llms.txt · Full route catalogue and pricing