Documentation / Compare
Rank countries | Salary Data API
Rank countriesEvery country ranked on its headline pay in US dollars, a year's pay, highest first.
GEThttps://api.salarydataapi.com/v1/rank
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/rank" \ -H "Authorization: Bearer YOUR_KEY"
Parameters
| Name | Type | What it is |
|---|---|---|
| region | string | Only one region europeasiaamericasmiddle-eastafricaoceania |
| by | string | In US dollars or at purchasing power. Default usd. usdppp |
| page | integer | The page, from 1. Default 1. |
| per_page | integer | Items a page, at most 200. Default 50. |
| cursor | string | From 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.
| 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 |
| rank | integer | Its place |
| yearly_usd | number | A year's pay in US dollars (or international dollars with by=ppp) |
Example answer
A real answer from today's figures, the first three items, with an Analyst key.
200GET /v1/rank
{
"data": [
{
"rank": 1,
"series": "se_e2n2j04a",
"name": "pay.mean.monthly",
"country": "fo",
"period": "2025",
"value": 316242.0,
"currency": "DKK",
"value_usd": 47787.01,
"occupation": null,
"sex": "all",
"age": null,
"education": null,
"hours": "all",
"area": null,
"yearly_usd": 573444.0
},
{
"rank": 2,
"series": "se_ah3fbgnn",
"name": "pay.mean.monthly",
"country": "il",
"period": "2026-07",
"value": 34301.0,
"currency": "ILS",
"value_usd": 11309.3,
"occupation": null,
"sex": "all",
"age": null,
"education": null,
"hours": "all",
"area": null,
"yearly_usd": 135712.0
},
{
"rank": 3,
"series": "se_xrv69pjs",
"name": "pay.monthly",
"country": "ch",
"period": "2010",
"value": 5979.0,
"currency": "CHF",
"value_usd": 5734.76,
"occupation": null,
"sex": "all",
"age": null,
"education": null,
"hours": "all",
"area": null,
"yearly_usd": 68817.0
}
],
"meta": {
"count": 3,
"next_cursor": "YzM",
"page": 1,
"per_page": 3,
"total": 34,
"total_pages": 12,
"next_page": 2,
"prev_page": null,
"yearly_usd": "Each headline as a year's pay: a month's times 12, a week's times 52, a day's times 260, an hour's times 2,080 (40 hours a week). In US dollars at each period's rate.",
"plan": "analyst"
}
}