Salary benchmark API

POST https://api.jobspipe.dev/v1/insights/salary/benchmark

The salary benchmark answers "what does this role pay?" from job postings that state pay: percentiles of advertised salary for an occupation code or a title match, optionally narrowed by country and seniority. Numbers are computed from deduplicated postings at request time. Occupations use ISCO-08 codes. Requires authentication. Each call that returns data costs 1 credit; an empty or suppressed answer, or an error, costs nothing.

Looking for occupation, industry, skill-trend or AI-exposure breakdowns? That labour-market data is available on request - book a demo and we'll walk you through it.

Request body

Send occupation_code or title (at least one).

Sample sizes and suppression

• A benchmark under 30 postings returns suppressed: true with percentiles: null.
• Every response carries a confidence tier: low (30-99 postings), medium (100-999), high (1000+), alongside the exact count.

Example

curl -X POST "https://api.jobspipe.dev/v1/insights/salary/benchmark" \
  -H "Authorization: Bearer jp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"title": "data engineer", "country": "US", "seniority": "senior"}'

{
  "occupation_code": null,
  "occupation_label": null,
  "window_days": 90,
  "country": "US",
  "count": 1874,
  "currency": "USD",
  "percentiles": { "p10": 128000, "p25": 150000, "p50": 172500, "p75": 198000, "p90": 225000 },
  "confidence": "high",
  "suppressed": false
}

Salary figures are advertised pay from postings that state it, annualized. Figures are in USD. They measure what employers offer publicly, which differs from survey-based earnings statistics.

Status codes

See errors for handling guidance. The endpoint is also in the API Explorer.