# 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.

## 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 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.

## Extract from a genuinely paid response

Dated snapshot from 2026-08-25, truncated to one item per array. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "siren": "095580841",
 "denomination": "TEREGA",
 "signaux_recrutement": {
  "recrute_activement": null,
  "annonces_actives": 0,
  "familles_rome": [],
  "methode": {
   "comptage": "correspondance_denomination",
   "zones": {
    "type": "departements",
    "interrogees": 5,
    "connues": 12
   },
   "annonces_examinees": 1050,
   "couverture_complete": false
  },
  "consulte_le": "2026-08-25T05:39:42.272Z"
 },
 "index_egapro": [
  {
   "annee": 2025,
   "note": 93
  }
 ],
 "effectif": {
  "tranche": "500 à 999 salariés",
  "annee": "2023"
 }
}
```

## 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.

## Calling the route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/entreprise/552032534/emploi

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534/emploi

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## 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.

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/entreprise/{siren}/emploi` | $0.02 | 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. |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/entreprise-siren-emploi.json)
- [Get the quote for /v1/entreprise/{siren}/emploi](https://api.sirenic.eu/v1/entreprise/552032534/emploi)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

---

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/