Documentation / Countries

A country's occupations | Salary Data API

A country's occupations
Starter and aboveA list, paged

The occupations a country publishes pay for, with their latest headline figure.

GEThttps://api.salarydataapi.com/v1/countries/{cc}/occupations

Try it

Runs against the live API with your key.
curl "https://api.salarydataapi.com/v1/countries/{cc}/occupations" \
  -H "Authorization: Bearer YOUR_KEY"

Parameters

NameTypeWhat it is
cccountryrequired Two-letter country code, such as jp or gb
seriesstringThe figure wanted, as pay.<statistic>.<period>: pay.median.monthly, pay.mean.yearly, pay.median.hourly, pay.p90.yearly.... Default pay.median.monthly.
qstringWords in the occupation's name
pageintegerThe page, from 1. Default 1.
per_pageintegerItems a page, at most 200. Default 50.
cursorstringFrom 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.

FieldTypeWhat it holds
ididThe occupation (oc_...)
slugstringIts name for addresses
namestringThe occupation as published, in English where the office gives it
classificationstringThe classification its code belongs to: ISCO-08, SOC, a national one
codestringIts code in that classification
countriesintegerHow many countries publish pay for it
seriesintegerHow many series carry it
latestobjectThe latest figure: period, value, currency

Example answer

Run it with your key for a real answer.

Errors