Documentation / Occupations
An occupation over time | Salary Data API
An occupation over timeStarter and aboveA list, paged
An occupation's pay in one country over every period it has.
GEThttps://api.salarydataapi.com/v1/occupations/{id}/history
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/occupations/{id}/history" \
-H "Authorization: Bearer YOUR_KEY"Parameters
| Name | Type | What it is |
|---|---|---|
| id | id | required The id (oc_...) |
| country | country | required Two-letter country code |
| series | string | The figure wanted, as pay.<statistic>.<period>: pay.median.monthly, pay.mean.yearly, pay.median.hourly, pay.p90.yearly.... Default pay.median.monthly. |
| from | period | The first period wanted (2019, 2019-Q1 or 2019-01) |
| to | period | The last period wanted |
| 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 |
|---|---|---|
| period | period | The period |
| value | number | The figure in its own currency |
| value_usd | number | In US dollars at that period's rate (Pro and Analyst) |
| area | string | The area, or null for the whole country |
Example answer
Run it with your key for a real answer.