Documentation / Guides

Occupations | Salary Data API

Occupations

Classifications, ISCO-08 codes across countries, slugs and one role across countries.

Each country publishes pay by occupation in its own classification. Many use ISCO-08, the international standard, or a national version of it that keeps its codes; others have their own (the United States' SOC, Japan's, the UK's).

Ids, slugs and codes

Every occupation has an id (oc_...), a slug for addresses (software-developers), its classification and its code. /v1/occupations/search?q= finds one by its name or code; any parameter that takes an occupation takes the id or the slug.

One role across countries

An ISCO-08 occupation is the same occupation in every country that publishes by ISCO-08, so /v1/occupations/{id}/pay gives its pay in each of them in one call, with US dollars to compare (Analyst). isco= on /v1/pay asks for one by its code.

The spread

Where a country publishes percentiles, /v1/occupations/{id}/distribution gives the 10th, 25th, 50th, 75th and 90th, and the mean, for one period.