API
Entwickler-API
Dasselbe Panel, das diese Website speist, als sauberes JSON. Authentifizierung per Bearer-Key.
Authentifizierung
Anonyme Calls erlauben Evaluation mit niedrigem Limit. Für gemessenen Zugriff einen ausgestellten Key als Bearer-Token senden.
curl /api/v1/overview
Live-Antwort
Lädt…
Endpunkte
GET /api/v1/overview— zentrale Panel-KPIs
GET /api/v1/salary?by=seniority|company|job_family|country— Mediangehalt nach Dimension
GET /api/v1/facets— Live-Filterwerte und Zeilenzahlen
GET /api/v1/explore?country=DE&salaried_only=true&sort=salary_desc— gefilterte Stellenzeilen
GET /api/v1/explore?as_of=2026-08-05&…— dieselbe Abfrage, reproduziert nach dem Wissensstand jenes Datums — der Zeitreise-Parameter (auch auf /salary)
GET /api/v1/explore.csv?…— gleiche Filter, CSV-Beispielexport
GET /api/v1/insights/comp-mix?by=sector— Equity- und Bonus-Erwähnungsquoten nach Sektor oder Jobfamilie
GET /api/v1/events?type=salary_revised_down&days=30— abgeleitete Änderungsereignisse — Gehaltskorrekturen, Schließungen, Wiedereröffnungen, je mit Quell-URL
GET /api/v1/insights/time-to-fill?by=job_family— Verweildauer von Anzeigen (nur unzensierte Spells), nach Jobfamilie/Land/Unternehmen
GET /api/v1/insights/market-mix?by=seniority— Zusammensetzung der offenen Stellen nach Funktion, Level oder Sektor
GET /api/v1/insights/benchmark-series?job_family=Engineering&country=US— täglich geschriebene Benchmark-Historie für einen Markt
GET /api/v1/quality— Feldvollständigkeit & FX-Provenienz
GET /api/v1/coverage— Abdeckungsregister pro Board
GET /api/v1/hiring?days=30— Zeitreihe offener Stellen
GET /api/v1/signals/disclosure?days=30— Trend der Gehaltsangabequote (Alle vs. EU)
GET /api/v1/signals/movers?days=30— Hiring-Beschleuniger / -Bremser
GET /api/v1/company/{platform}/{token}— Signale je Unternehmen
Query-Builder
Request gegen das Live-Panel zusammenstellen und als curl kopieren.
curl …
Datenwörterbuch
Feldsemantik für Stellenzeilen. Unbekannte Werte sind null — nie still imputiert.
| Feld | Typ | Bedeutung |
|---|---|---|
| salary_min / salary_max | number|null | Arbeitgeberseitig ausgewiesene Spannengrenzen in Originalwährung und -periode. |
| currency | ISO 4217|null | ISO-4217-Code, wenn aus der Anzeige bestimmbar; sonst null. |
| period | year|month|hour | Ausgewiesene Zahlungsperiode (Jahr, Monat oder Stunde). |
| salary_source | stated|none | 'stated' nur, wenn der Arbeitgeber die Zahl geschrieben hat. Nie modelliert. |
| annual_usd | number|null | Mittelwert annualisiert in USD mit datierten Referenzkursen; null bei unbekannter Währung. |
| confidence | 0–1|null | Konfidenz des deterministischen Extraktors für die Spanne. |
| has_equity / has_bonus | 0|1|null | Equity/Bonus im Vergütungsauszug erwähnt; null = Auszug nicht ausgewertet (nie geraten) |
| as_of | date (param) | jede explore/salary-Abfrage akzeptiert as_of=YYYY-MM-DD und antwortet nach dem Wissensstand jenes Tages — jede zitierte Zahl bleibt reproduzierbar |
| quality_flags | string[] | Bekannte Lücken der Zeile, z. B. no_country, no_currency. |
| observed_at | ISO 8601 | Wann dieser exakte Zustand zuletzt auf dem Quellboard beobachtet wurde. |
| first_seen_at | ISO 8601 | Wann die Stelle erstmals ins Live-Panel kam. |
| url | string | Öffentliche Quell-URL — jede Zeile ist auditierbar. |
| fx_as_of | date | Datum des FX-Snapshots für die USD-Umrechnung dieser Antwort. |
Fehler
Alle Fehler liefern einen JSON-Body mit stabiler Form und passendem Statuscode.
{ "error": "explanation", "status": 4xx }
Quoten gelten pro Key und UTC-Tag. 429 bedeutet, dass das Tageskontingent erschöpft ist.
Versionierung & Deprecation
- v1-Endpunkte sind additiv: neue Felder können erscheinen, bestehende Felder ändern innerhalb v1 nie ihre Bedeutung.
- Breaking Changes erscheinen als /api/v2; beide Versionen laufen mindestens 90 Tage parallel.
- Deprecations werden im Changelog und per Response-Header angekündigt, bevor etwas entfernt wird. Changelog →
ZeitpunktgenauAs-of-Semantik für reproduzierbare Forschung
QuellenverknüpftÖffentliche Quell-URL auf jeder Zeile
Ausgewiesen vs. normalisiertOriginale lokale Spanne bleibt erhalten
Explizite QuotenDeterministische Tagesmessung je Key