Documentation / Guides

Quick start | Salary Data API

Quick start

A key, the first call and the answer, in three minutes.

Three steps: a key, a call, an answer. Every endpoint page has Run, so you can also do all of this in the browser.

1. Get a key

Sign in with Google at salarydataapi.com/signup. A free key is made at once and shown once; it is also saved in this browser, so every documentation page has it in Try it.

2. Make the first call

A country's median yearly pay, the latest period:

curl "https://api.salarydataapi.com/v1/pay?country=gb&series=pay.median.yearly" \
  -H "Authorization: Bearer YOUR_KEY"

3. Read the answer

Every answer has the same shape: the figures in data, the paging and any notes in meta.

{
  "data": [
    {
      "series": "se_4762t04r",
      "name": "pay.median.yearly",
      "country": "gb",
      "period": "2025",
      "value": 32890.0,
      "currency": "GBP",
      "value_usd": null,
      "occupation": null,
      "sex": "all"
    }
  ],
  "meta": { "count": 1, "plan": "free", "value_usd": "In US dollars with Pro and above" }
}

Next: how figures are named, every parameter of /v1/pay, and every country.