Documentation / Series
Find series | Salary Data API
Find seriesEvery pay series that matches what you ask for: a country, a statistic, a period of pay and any breakdown.
GEThttps://api.salarydataapi.com/v1/series?series=pay.mean
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/series?series=pay.mean" \ -H "Authorization: Bearer YOUR_KEY"
Parameters
| Name | Type | What it is |
|---|---|---|
| country | country | required Two-letter country code |
| series | string | pay.<statistic>.<period>, or part of it: pay.median, pay.mean.yearly |
| occupation | id | An occupation id (oc_...) or its slug, such as software-developers |
| isco | string | An ISCO-08 occupation code (1 to 4 digits), where the country publishes by ISCO |
| sex | string | Sex. Default all. allfemalemale |
| age | string | An age band as /v1/countries/{cc}/breakdowns lists it, such as 25-34 |
| education | string | A level of schooling as /v1/countries/{cc}/breakdowns lists it |
| hours | string | Full-time, part-time or everyone. Default all. allfull_timepart_time |
| table | id | Only one table (tb_...) |
| 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 |
|---|---|---|
| id | id | The series (se_...) |
| name | string | pay.<statistic>.<period>[.net] |
| statistic | string | median, mean, p10 to p90, minimum, starting, bonus or reported |
| per | string | hour, day, week, month or year |
| net | boolean | True for pay after tax |
| country | string | Two-letter country code |
| currency | string | ISO 4217 currency |
| occupation | id | The occupation (oc_...), or null |
| sex | string | all, female or male |
| age | string | Age band, or null |
| education | string | Level of schooling, or null |
| hours | string | all, full_time or part_time |
| table | id | The table it belongs to (tb_...) |
| first_period | period | Its first period |
| last_period | period | Its latest period |
| areas | integer | How many areas it is published for |
Example answer
Run it with your key for a real answer.