API
API développeurs
Le même panel que celui qui alimente ce site, en JSON propre. Authentifiez-vous avec une clé Bearer.
Authentification
Les appels anonymes permettent une évaluation avec une limite basse. Passez une clé émise comme jeton Bearer pour un accès mesuré.
curl /api/v1/overview
Réponse en direct
Chargement…
Endpoints
GET /api/v1/overview— KPI phares du panel
GET /api/v1/salary?by=seniority|company|job_family|country— rémunération médiane par dimension
GET /api/v1/facets— valeurs de filtres en direct et décomptes de lignes
GET /api/v1/explore?country=DE&salaried_only=true&sort=salary_desc— lignes de postes filtrées
GET /api/v1/explore?as_of=2026-08-05&…— la même requête, reproduite telle que le panel était connu à cette date — le paramètre de voyage dans le temps (aussi sur /salary)
GET /api/v1/explore.csv?…— mêmes filtres, export d'échantillon CSV
GET /api/v1/insights/comp-mix?by=sector— taux de mention d'equity & de bonus par secteur ou famille de métiers
GET /api/v1/events?type=salary_revised_down&days=30— événements de changement dérivés — révisions salariales, clôtures, réouvertures, chacun avec son URL source
GET /api/v1/insights/time-to-fill?by=job_family— distribution de la durée de vie des offres (épisodes non censurés uniquement), par famille/pays/entreprise
GET /api/v1/insights/market-mix?by=seniority— composition du recrutement ouvert par fonction, niveau ou secteur
GET /api/v1/insights/benchmark-series?job_family=Engineering&country=US— historique de benchmark écrit quotidiennement pour un marché
GET /api/v1/quality— complétude des champs & provenance des taux de change
GET /api/v1/coverage— registre de couverture par site d'offres
GET /api/v1/hiring?days=30— séries temporelles des postes ouverts
GET /api/v1/signals/disclosure?days=30— tendance de la divulgation salariale (Tous vs UE)
GET /api/v1/signals/movers?days=30— recrutements en accélération / décélération
GET /api/v1/company/{platform}/{token}— signaux par entreprise
Constructeur de requêtes
Composez une requête sur le panel en direct et copiez-la au format curl.
curl …
Dictionnaire de données
Sémantique des champs des lignes de postes. Les valeurs inconnues sont null — jamais imputées en silence.
| Champ | Type | Signification |
|---|---|---|
| salary_min / salary_max | number|null | Bornes de la fourchette déclarée par l'employeur dans la devise et la période d'origine. |
| currency | ISO 4217|null | Code ISO 4217 quand il est déterminable depuis l'offre ; null sinon. |
| period | year|month|hour | Période de paie telle que déclarée (année, mois ou heure). |
| salary_source | stated|none | 'stated' uniquement quand l'employeur a écrit le chiffre. Jamais modélisé. |
| annual_usd | number|null | Point médian annualisé en USD avec des taux de change de référence datés ; null quand la devise est inconnue. |
| confidence | 0–1|null | Confiance de l'extracteur déterministe pour la fourchette déclarée. |
| has_equity / has_bonus | 0|1|null | equity / bonus mentionnés dans l'extrait de rémunération ; null = extrait non évalué (jamais deviné) |
| as_of | date (param) | toute requête explore/salary accepte as_of=YYYY-MM-DD et répond à partir des connaissances de ce jour-là — citez un chiffre et n'importe qui peut le reproduire |
| quality_flags | string[] | Lacunes connues sur cette ligne, p. ex. no_country, no_currency. |
| observed_at | ISO 8601 | Dernier moment où cet état exact a été observé sur le site source. |
| first_seen_at | ISO 8601 | Moment où l'offre est entrée pour la première fois dans le panel en direct. |
| url | string | URL de l'offre source publique — chaque ligne est auditable. |
| fx_as_of | date | Date de l'instantané de change utilisé pour la conversion en USD dans cette réponse. |
Erreurs
Toutes les erreurs renvoient un corps JSON de forme stable avec le code de statut approprié.
{ "error": "explanation", "status": 4xx }
Les quotas s'appliquent par clé et par jour UTC. 429 signifie que le quota du jour est épuisé.
Versionnage & dépréciation
- Les endpoints v1 sont additifs : de nouveaux champs peuvent apparaître, les champs existants ne changent jamais de sens au sein de v1.
- Les changements incompatibles sont livrés sous /api/v2, les deux versions étant servies en parallèle pendant au moins 90 jours.
- Les dépréciations sont annoncées dans le journal des modifications et via les en-têtes de réponse avant tout retrait. Journal des modifications →
Point-in-timeSémantique de date de référence pour une recherche reproductible
Relié aux sourcesURL de l'offre publique sur chaque ligne de poste
Déclaré vs normaliséFourchette locale d'origine conservée
Quotas explicitesComptage quotidien déterministe par clé