Documentation / Compare

Compare countries | Salary Data API

Compare countries

The countries you name side by side on one figure, in their own currency and in US dollars.

GEThttps://api.salarydataapi.com/v1/compare/countries

Try it

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

Parameters

NameTypeWhat it is
countriescountriesrequired Two to ten country codes, comma separated: gb,fi,jp
seriesstringThe 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.

FieldTypeWhat it holds
seriesidThe series (se_...)
namestringWhat the figure is, as pay.<statistic>.<period>, for example pay.median.monthly
countrystringTwo-letter country code
periodperiodThe period the figure covers: 2025, 2025-Q2 or 2025-06
valuenumberThe figure in its own currency, in whole units of money
currencystringISO 4217 currency
value_usdnumberThe figure in US dollars at that period's rate (Pro and Analyst; null on other plans)
occupationidThe occupation (oc_...), or null for all occupations
sexstringall, female or male
agestringThe age band, or null for all ages
educationstringThe level of schooling, or null for all levels
hoursstringall, full_time or part_time
areastringThe area, or null for the whole country

Example answer

Run it with your key for a real answer.

Errors