Documentation / Countries
Headline pay | Salary Data API
Headline payFree keyMCP tool: country_headline
A country's headline pay figure: everyone, every occupation, the median where it publishes one, else the mean.
GEThttps://api.salarydataapi.com/v1/countries/{cc}/headline
Try it
No key in this browser yet. Get a free key: it is filled in here once made.
Runs against the live API with your key.
curl "https://api.salarydataapi.com/v1/countries/{cc}/headline" \
-H "Authorization: Bearer YOUR_KEY"Parameters
| Name | Type | What it is |
|---|---|---|
| cc | country | required Two-letter country code, such as jp or gb |
Returns
One item in data, with these fields.
| Field | Type | What it holds |
|---|---|---|
| series | id | The series (se_...) |
| name | string | What the figure is, as pay.<statistic>.<period>, for example pay.median.monthly |
| country | string | Two-letter country code |
| period | period | The period the figure covers: 2025, 2025-Q2 or 2025-06 |
| value | number | The figure in its own currency, in whole units of money |
| currency | string | ISO 4217 currency |
| value_usd | number | The figure in US dollars at that period's rate (Pro and Analyst; null on other plans) |
| occupation | id | The occupation (oc_...), or null for all occupations |
| sex | string | all, female or male |
| age | string | The age band, or null for all ages |
| education | string | The level of schooling, or null for all levels |
| hours | string | all, full_time or part_time |
| area | string | The area, or null for the whole country |
Example answer
Run it with your key for a real answer.