Sign inGet a key

Salary Data API documentation

Official pay figures for 49 countries, in one API

Salary Data API holds the pay figures national statistics offices publish: medians and means, percentiles from the 10th to the 90th, pay by occupation, sex, age, schooling and area, from the first year each office published to the latest release. 83,837,497 figures in 3,884 tables, every one kept in its own currency and period, with US dollars, today's prices and purchasing power alongside.

People build salary benchmarks and offer letters, relocation and cost-of-living tools, HR and payroll analytics, pay equity reports, research and journalism on it. Every endpoint answers in the same shape, every id is stable, and every figure says where in time it sits.

There are 63 endpoints, each with its own page: what it does, Try it against the live API with your key, its parameters, what it returns and a real answer.

Start here

01

Get a key

Sign in with Google. A free key is made at once and saved in this browser for these pages.

Get a free key
02

Make the first call

Send it in an Authorization header. Every page has Run, with your key already in.

Quick start
03

Read the answer

Figures are in data, the paging and notes in meta. Errors have a code that never changes.

Answers and errors
GEThttps://api.salarydataapi.com/v1/payTry it

Every subject

Pay figures

How a figure is named (pay.median.monthly), what each statistic means, gross and net, hours, and how /v1/pay picks the series that answers you.

Read the guide

Occupations

How each country classifies occupations, why ISCO-08 codes compare across countries, slugs, and one role across countries.

Read the guide

Breakdowns

Sex, age, schooling, hours and area: what each country publishes, how to ask for it, and the gender pay gap.

Read the guide

Prices and money

Each country's own consumer prices, exchange rates by period, purchasing power, and figures in today's prices.

Read the guide

Every endpoint

The dot is the first plan that reads it: Free key Starter Pro Analyst

Basics

The API itself: your usage, its status, its changes, what it covers and the words it uses.
/The API's name, its base address and where its documentation and status are./v1/usageYour plan, the calls made today and this month, your limits and when they reset. Free to call: it never counts./v1/statusWhether the API is answering, and how current its figures are./v1/changelogEvery change to the API, newest first. v1 only ever gains fields./v1/coverageFor each country: its tables, series and figures, the years they reach and the breakdowns it publishes./v1/glossaryEvery statistic, pay period and word the API uses, in plain words.

Pay

The one call most people need: a country, a figure of pay, any breakdown, the latest period or any other.
/v1/payThe pay figure you ask for: a country, a statistic and period of pay, and any breakdown. The latest period unless you ask for others.

Countries

Each country: what it publishes, its headline pay, its tables, occupations, breakdowns, history and releases.
/v1/countriesEvery country with figures, its region, its currency and how much it publishes./v1/countries/{cc}A country: its region, currency, tables, the years its figures reach and the breakdowns it publishes./v1/countries/{cc}/headlineA country's headline pay figure: everyone, every occupation, the median where it publishes one, else the mean./v1/countries/{cc}/tablesThe pay tables a country publishes, each with its series, figures and the periods it covers./v1/countries/{cc}/occupationsThe occupations a country publishes pay for, with their latest headline figure./v1/countries/{cc}/breakdownsEvery value a country publishes pay by: its sexes, age bands, levels of schooling, hours and statistics./v1/countries/{cc}/historyA country's headline pay over every period it has, oldest first./v1/countries/{cc}/releasesThe releases from one country, newest first.

Regions

The six regions, their countries and their pay side by side.
/v1/regionsThe six regions and how many countries each has./v1/regions/{region}A region's countries, each with its headline pay figure./v1/regions/{region}/compareA region's countries side by side in US dollars, highest first, on one figure.

Series

One line of figures over time: find it, read it, see it change, in today's prices or another currency, and by area.
/v1/seriesEvery pay series that matches what you ask for: a country, a statistic, a period of pay and any breakdown./v1/series/{id}A series: what it measures, who it covers, its table and the periods it has./v1/series/{id}/observationsEvery figure of a series, oldest first, for the whole country or one area./v1/series/{id}/latestThe latest figure of a series for the whole country./v1/series/{id}/changeHow a series moved: each period against the one a year before, in money and per cent./v1/series/{id}/realA series in the prices of the latest period, from the country's own consumer price index, so the years compare./v1/series/{id}/convertedA series in US dollars or euros at each period's rate, or at purchasing power parity./v1/series/{id}/areasA series' latest figure in every area it is published for.

Tables

The sets of series each country publishes together.
/v1/tablesEvery pay table, newest changes first./v1/tables/{id}A table: what it holds, its periods and what it is broken down by./v1/tables/{id}/seriesThe pay series in a table./v1/tables/{id}/observationsEvery figure in a table for one period, the latest when left out, each with its series.

Occupations

Every occupation with pay, in every classification, and one role across countries.
/v1/occupationsEvery occupation with pay, in every classification, the most widely published first./v1/occupations/searchOccupations whose name or code matches what you type./v1/occupations/{id}An occupation: its classification and code, and the countries that publish pay for it./v1/occupations/{id}/payAn occupation's latest pay in every country that publishes it, in one call, with US dollars to compare./v1/occupations/{id}/countriesThe countries that publish an occupation, with the series and periods each has./v1/occupations/{id}/historyAn occupation's pay in one country over every period it has./v1/occupations/{id}/distributionAn occupation's pay from the 10th to the 90th percentile, where the country publishes them./v1/occupations/{id}/compareAn occupation in the countries you name, side by side in US dollars./v1/occupations/{id}/areasAn occupation's latest pay in each area of one country.

Pay breakdowns

Pay by sex, age and schooling, every headline in one call, and the gender pay gap.
/v1/pay/headlineEvery country's headline pay figure in one call./v1/pay/by-sexWomen's and men's pay in a country, side by side, for everyone or one occupation./v1/pay/by-agePay in each age band of a country, youngest first./v1/pay/by-educationPay at each level of schooling in a country./v1/pay/gender-gapHow much less women are paid than men, in per cent of men's pay, by period, for everyone or each occupation and age band.

Areas and industries

Regions, states and cities within a country, and pay by industry where it is published.
/v1/countries/{cc}/areasThe areas a country publishes pay for: its regions, states, counties or cities./v1/areas/{id}An area: its country and how many pay series it has./v1/areas/{id}/occupationsThe latest pay of each occupation published for an area./v1/industriesThe industries pay is published by, where a country publishes pay by industry./v1/industries/{id}An industry, with its pay for every occupation together./v1/industries/{id}/occupationsPay for each occupation in an industry, the best paid first.

Compare

Countries, occupations and periods side by side, and every country ranked.
/v1/compare/countriesThe countries you name side by side on one figure, in their own currency and in US dollars./v1/compare/occupationsThe occupations you name side by side in one country./v1/compare/periodsA series in two periods, with the change between them as published and in today's prices./v1/rankEvery country ranked on its headline pay in US dollars, a year's pay, highest first.

Prices and money

Consumer prices, exchange rates and purchasing power, and the calls that convert and adjust an amount.
/v1/context/prices/{cc}A country's consumer price index from its own statistics office, by period./v1/context/exchange/{currency}A currency against the US dollar and the euro, by month, quarter and year: the average of each period's official daily rates./v1/context/ppp/{cc}A country's purchasing power parity for private consumption: units of its currency to one international dollar, by year./v1/currenciesEvery currency the figures are in, with the latest rate to the US dollar./v1/convertAn amount from one currency to another at a period's average rate./v1/adjustAn amount of a country's money in one year, in the prices of another year, from its consumer price index.

Releases

New and changed tables as they reach the API.
/v1/releasesNew and changed pay tables as they reach the API, newest first./v1/releases/latestEach country's latest release./v1/releases/{id}A release: its table, the periods it brought and its headline figures.

Calls to start with

A figure of payGET /v1/payA country's headlineGET /v1/countries/{cc}/headlineFind an occupationGET /v1/occupations/searchCompare countriesGET /v1/compare/countriesA series over timeGET /v1/series/{id}/observations

For assistants and agents

MCP server

The API as tools for Claude, ChatGPT, Cursor and Claude Code. The MCP guide

https://salarydataapi.com/mcp

Agent skill

Teaches an agent the API: which call answers which question, and how to read the answers. More

https://salarydataapi.com/skill.md

The manual

Every guide and endpoint in one Markdown file, for an agent to read in one go. Also at /llms.txt.

https://salarydataapi.com/documentation/manual.md

OpenAPI

The whole API as OpenAPI 3.1, for code generators and Postman. More

https://salarydataapi.com/openapi.json

Plans in short

Free key

  • 50 calls a day
  • 1 call a second
  • The latest period
  • National totals in own currency

Starter

  • 10,000 calls a month
  • 5 calls a second
  • The latest 3 years
  • Breakdowns: occupation, sex, age, area, schooling

Pro

  • 100,000 calls a month
  • 10 calls a second
  • Full history
  • US dollars at each period's rate

Analyst

  • 500,000 calls a month
  • 20 calls a second
  • Full history
  • One role across countries, pay gaps, MCP

Over the allowance, calls are refused and never billed. Every plan in full on pricing.

What is new

Table titles are now plain descriptions of what each table holds (Yearly pay by occupation and sex, United Kingdom); ids are unchanged. /v1/currencies answers at once. Fields unchanged.

v1 opens: 63 endpoints over pay, countries, regions, series, tables, occupations, breakdowns, areas, industries, comparisons, prices and money, and releases.

The changelog

The rest

Authentication

Your key in an Authorization: Bearer header, or X-API-Key. Never in the address. Authentication

Errors

Every error has a fixed code, a message and a link to what to do. Errors

Pagination

Lists take page or cursor; meta says what comes next. Pagination

Limits

Calls a second and a day or month, in headers on every answer. Plans and limits

Status

Whether the API is answering, and its last release. Status

Support

A question, a figure that looks wrong, a refund: open a ticket. Support

Questions people ask

Where do the figures come from?

Every figure is one a national statistics office publishes, read from what it releases and kept with its own periods and currency. Nothing is modelled or estimated: a figure the office has not published is not in the API.

How current is it?

Releases reach the API the day they are published. Each figure carries its period, and /v1/releases lists what came in and when.

Can I compare pay across countries?

Yes. Every figure keeps its own currency; Pro and Analyst add value_usd at its period's rate, and /v1/series/{id}/converted gives euros or purchasing power. One role across countries is an Analyst call.

What is the difference between median and mean?

The median is the middle: half are paid less. The mean is the average, pulled up by high pay. /v1/glossary has every statistic.

What happens when I go over my allowance?

Calls are refused with quota_exceeded until the day or month starts again. Nothing is ever billed beyond the plan. Plans and limits

Can I use it in my product?

Yes, in your own products, reports and sites. The figures themselves may not be resold or republished in bulk: the terms say so in full.