Documentation / Basics

Glossary | Salary Data API

Glossary
Free key

Every statistic, pay period and word the API uses, in plain words.

GEThttps://api.salarydataapi.com/v1/glossary

Try it

This endpoint takes no parameters.

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

Returns

One item in data, with these fields.

FieldTypeWhat it holds
termstringThe word
kindstringstatistic, per, field or value
meansstringWhat it means

Example answer

A real answer from today's figures, with an Analyst key.

200GET /v1/glossary
{
    "data": [
        {
            "term": "median",
            "kind": "statistic",
            "means": "The middle of pay: half of the people counted are paid less, half more."
        },
        {
            "term": "mean",
            "kind": "statistic",
            "means": "The average: all pay added up and divided by the people counted. High pay pulls it above the median."
        },
        {
            "term": "p10, p20 ... p90",
            "kind": "statistic",
            "means": "Percentiles: p10 is the pay that 10 per cent are paid less than; p25 and p75 are the quartiles."
        },
        {
            "term": "minimum",
            "kind": "statistic",
            "means": "The legal minimum wage."
        },
        {
            "term": "starting",
            "kind": "statistic",
            "means": "Starting pay, such as graduates' first salaries."
        },
        {
            "term": "bonus",
            "kind": "statistic",
            "means": "Bonuses and other special payments, kept apart from regular pay."
        },
        {
            "term": "reported",
            "kind": "statistic",
            "means": "The office publishes the figure as the pay of the group without naming its statistic."
        },
        {
            "term": "hourly, daily, weekly, monthly, yearly",
            "kind": "per",
            "means": "What one figure of pay covers: an hour, a day, a week, a month or a year."
        },
        {
            "term": ".net",
            "kind": "per",
            "means": "At the end of a name (pay.mean.monthly.net): pay after income tax and social contributions. Without it, pay is gross."
        },
        {
            "term": "series",
            "kind": "field",
            "means": "One line of figures over time: one statistic, for one group of people, in one country."
        },
        {
            "term": "table",
            "kind": "field",
            "means": "A set of series a country publishes together."
        },
        {
            "term": "headline",
            "kind": "field",
            "means": "A country's figure for everyone in every occupation, gross: its median where it publishes one, else its mean."
        },
        {
            "term": "value",
            "kind": "field",
            "means": "A figure in the country's own currency, in whole units of money."
        },
        {
            "term": "value_usd",
            "kind": "field",
            "means": "The figure in US dollars at the average rate of its own period."
        },
        {
            "term": "ppp",
            "kind": "value",
            "means": "Purchasing power parity: units of a currency that buy what one US dollar buys in the United States, so pay compares by what it buys."
        },
        {
            "term": "real, today's prices",
            "kind": "value",
            "means": "A figure in the prices of the latest period, from the country's own consumer price index."
        },
        {
            "term": "hours",
            "kind": "field",
            "means": "all, full_time or part_time: who is counted by the hours they work."
        },
        {
            "term": "period",
            "kind": "field",
            "means": "2025 for a year, 2025-Q2 for a quarter, 2025-H1 for a half, 2025-06 for a month."
        },
        {
            "term": "occupation",
            "kind": "field",
            "means": "An occupation as the country classifies it. ISCO-08 codes are shared by many countries, so one ISCO-08 occupation compares across them."
        }
    ],
    "meta": {
        "plan": "analyst"
    }
}

Errors