Documentation / Pay breakdowns

Every headline | Salary Data API

Every headline

Every country's headline pay figure in one call.

GEThttps://api.salarydataapi.com/v1/pay/headline

Try it

Runs against the live API with your key.
curl "https://api.salarydataapi.com/v1/pay/headline" \
  -H "Authorization: Bearer YOUR_KEY"

Parameters

NameTypeWhat it is
regionstringOnly one region
europeasiaamericasmiddle-eastafricaoceania
pageintegerThe page, from 1. Default 1.
per_pageintegerItems a page, at most 200. Default 50.
cursorstringFrom next_cursor in the last answer; page wins when both are sent

Returns

A list in data, each item with these fields, and the paging in meta.

FieldTypeWhat it holds
seriesidThe series (se_...)
namestringWhat the figure is, as pay.<statistic>.<period>, for example pay.median.monthly
countrystringTwo-letter country code
periodperiodThe period the figure covers: 2025, 2025-Q2 or 2025-06
valuenumberThe figure in its own currency, in whole units of money
currencystringISO 4217 currency
value_usdnumberThe figure in US dollars at that period's rate (Pro and Analyst; null on other plans)
occupationidThe occupation (oc_...), or null for all occupations
sexstringall, female or male
agestringThe age band, or null for all ages
educationstringThe level of schooling, or null for all levels
hoursstringall, full_time or part_time
areastringThe area, or null for the whole country

Example answer

A real answer from today's figures, the first three items, with an Analyst key.

200GET /v1/pay/headline
{
    "data": [
        {
            "series": "se_f09a22bv",
            "name": "pay.median.monthly",
            "country": "ar",
            "period": "2026-06",
            "value": 2416818.05,
            "currency": "ARS",
            "value_usd": null,
            "occupation": null,
            "sex": "all",
            "age": null,
            "education": null,
            "hours": "all",
            "area": null
        },
        {
            "series": "se_q4v7fsvc",
            "name": "pay.mean.monthly",
            "country": "be",
            "period": "2022",
            "value": 4076.0,
            "currency": "EUR",
            "value_usd": 4282.53,
            "occupation": null,
            "sex": "all",
            "age": null,
            "education": null,
            "hours": "full_time",
            "area": null
        },
        {
            "series": "se_v2w9ecwr",
            "name": "pay.mean.monthly",
            "country": "br",
            "period": "2026-Q2",
            "value": 3657.0,
            "currency": "BRL",
            "value_usd": 724.61,
            "occupation": null,
            "sex": "all",
            "age": null,
            "education": null,
            "hours": "all",
            "area": null
        }
    ],
    "meta": {
        "count": 3,
        "next_cursor": "YzM",
        "page": 1,
        "per_page": 3,
        "total": 38,
        "total_pages": 13,
        "next_page": 2,
        "prev_page": null,
        "plan": "analyst"
    }
}

Errors