Documentation / Occupations
One role across countries | Salary Data API
One role across countriesAn occupation's latest pay in every country that publishes it, in one call, with US dollars to compare.
GEThttps://api.salarydataapi.com/v1/occupations/{id}/pay
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}/pay" \
-H "Authorization: Bearer YOUR_KEY"Parameters
| Name | Type | What it is |
|---|---|---|
| id | id | required The id (oc_...) |
| 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. |
| 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 |
Example answer
Run it with your key for a real answer.