Documentation / Occupations
Every occupation | Salary Data API
Every occupationFree keyA list, paged
Every occupation with pay, in every classification, the most widely published first.
GEThttps://api.salarydataapi.com/v1/occupations?classification=ISCO-08
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?classification=ISCO-08" \ -H "Authorization: Bearer YOUR_KEY"
Parameters
| Name | Type | What it is |
|---|---|---|
| country | country | Only those one country publishes |
| classification | string | Only one classification, such as ISCO-08 |
| 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 occupation (oc_...) |
| slug | string | Its name for addresses |
| name | string | The occupation as published, in English where the office gives it |
| classification | string | The classification its code belongs to: ISCO-08, SOC, a national one |
| code | string | Its code in that classification |
| countries | integer | How many countries publish pay for it |
| series | integer | How many series carry it |
Example answer
A real answer from today's figures, the first three items, with an Analyst key.
200GET /v1/occupations?classification=ISCO-08
{
"data": [
{
"id": "oc_6jy0kt18",
"slug": "technicians-and-associate-professionals",
"name": "TECHNICIANS AND ASSOCIATE PROFESSIONALS",
"classification": "ISCO-08",
"code": "3",
"countries": 4,
"series": 2972
},
{
"id": "oc_rqdbs4ag",
"slug": "service-and-sales-workers",
"name": "SERVICE AND SALES WORKERS",
"classification": "ISCO-08",
"code": "5",
"countries": 4,
"series": 2915
},
{
"id": "oc_6rhr75a0",
"slug": "professionals",
"name": "PROFESSIONALS",
"classification": "ISCO-08",
"code": "2",
"countries": 4,
"series": 2877
}
],
"meta": {
"count": 3,
"next_cursor": "YzM",
"page": 1,
"per_page": 3,
"total": 1432,
"total_pages": 478,
"next_page": 2,
"prev_page": null,
"plan": "analyst"
}
}