Documentation / Compare
Compare occupations | Salary Data API
Compare occupationsStarter and above
The occupations you name side by side in one country.
GEThttps://api.salarydataapi.com/v1/compare/occupations
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/compare/occupations" \ -H "Authorization: Bearer YOUR_KEY"
Parameters
| Name | Type | What it is |
|---|---|---|
| country | country | required Two-letter country code |
| occupations | ids | required Two to ten occupations (oc_...), comma separated |
| 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. |
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.