# Employment Growth API > How fast the number of people in work is growing in each economy, on one comparable screen — total employment growth from the OECD's official Quarterly National Accounts as an API, live, no key. Employment growth is the jobs number: the change in the total count of people employed, the demand-side companion to the unemployment rate. The two can move independently — employment can keep rising while the unemployment rate holds flat if the labour force is growing too — so the jobs print is watched in its own right as a read on how much hiring the real economy is doing. The OECD harmonises and seasonally adjusts the figures so they are genuinely comparable across countries. This API computes the two growth rates people quote — quarter-on-quarter (the latest quarter's pace) and year-on-year (versus the same quarter a year earlier) — from the OECD's total-employment count. The board endpoint ranks every economy by its year-on-year employment growth, so you can see where hiring is strongest and where jobs are being shed. The momentum endpoint ranks by the latest quarter-on-quarter move. The country endpoint gives one economy's employment growth with a plain-language read. Each reading carries its own quarter and discontinued series are excluded, so the board is genuinely current. The jobs / labour-demand cut — distinct from the harmonised unemployment-rate board (this is the count of people in work, not the share out of work), the leading-indicator and GDP boards, the annual IMF World Economic Outlook database, and the generic multi-provider data aggregator. Figures are quarterly, in percent. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/employment-api/..." ``` ## Pricing - **Free** (Free) — 815 calls/Mo, 2 req/s - **Starter** ($11/Mo) — 17,300 calls/Mo, 6 req/s - **Pro** ($34/Mo) — 88,000 calls/Mo, 16 req/s - **Business** ($78/Mo) — 494,000 calls/Mo, 40 req/s ## Endpoints ### Board #### `GET /v1/board` — Economies ranked by year-on-year employment growth **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/employment-api/v1/board?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by year-on-year growth in the number of people employed (total economy, seasonally adjusted), computed from the OECD's employment count. This is the jobs number — the demand-side companion to the unemployment rate; the two can move independently. Each row carries its own quarter; discontinued series are excluded. Quarterly, cached a few hours.", "board": [ { "code": "ESP", "name": "Spain", "quarter": "2026-Q1", "reading": "hiring strongly", "is_aggregate": false, "employment_qoq": 0.63, "employment_yoy": 2.57 }, { "code": "PRT", "name": "Portugal", "quarter": "2026-Q1", "reading": "employment growing", "is_aggregate": false, "employment_qoq": -0.22, "employment_yoy": 1.94 }, { "code": "BGR", "name": "Bulgaria", "quarter": "2026-Q1", "reading": "employment growing", "is_aggregate": false, "employment_qoq": 0.22, "employment_yoy": 1.73 }, { "code": "DNK", "name": "Denmark", "quarter": "2026-Q1", "reading": "employment growing", …(truncated, see openapi.json for full schema) ``` ### Momentum #### `GET /v1/momentum` — Economies ranked by the latest quarter-on-quarter employment move **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/employment-api/v1/momentum?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by the latest quarter-on-quarter change in employment — the freshest read on hiring momentum. Year-on-year alongside. Quarterly, cached a few hours.", "board": [ { "code": "CZE", "name": "Czechia", "quarter": "2026-Q1", "is_aggregate": false, "employment_qoq": 2.5, "employment_yoy": 1.07 }, { "code": "ESP", "name": "Spain", "quarter": "2026-Q1", "is_aggregate": false, "employment_qoq": 0.63, "employment_yoy": 2.57 }, { "code": "NOR", "name": "Norway", "quarter": "2026-Q1", "is_aggregate": false, "employment_qoq": 0.61, "employment_yoy": 0.71 }, { "code": "EST", "name": "Estonia", "quarter": "2026-Q1", "is_aggregate": false, "employment_qoq": 0.57, "employment_yoy": 0.53 }, { "code": "DNK", "name": "Denmark", "quarter": "2026-Q1", "is_aggregate": false, "employment_qoq": 0.52, "employment_yoy": 1.27 }, { …(truncated, see openapi.json for full schema) ``` ### Country #### `GET /v1/country` — One economy's employment growth, year-on-year and quarter-on-quarter **Parameters:** - `country` (query, required, string) — ISO-3 code or name Example: `ESP` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/employment-api/v1/country?country=ESP" ``` **Response:** ```json { "data": { "code": "ESP", "name": "Spain", "note": "One economy's total-employment growth, year-on-year and quarter-on-quarter (seasonally adjusted). A positive change means more people are in work than a year earlier — the jobs companion to the unemployment rate. Quarterly, cached a few hours.", "source": "OECD Quarterly National Accounts (SDMX)", "quarter": "2026-Q1", "is_aggregate": false, "employment_growth": { "qoq": 0.63, "yoy": 2.57, "reading": "hiring strongly" } }, "meta": { "timestamp": "2026-06-13T04:44:45.328Z", "request_id": "868e84a0-e047-4471-a8a7-6709b5baae00" }, "status": "ok", "message": "Country employment retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/employment-api/v1/meta" ``` **Response:** ```json { "data": { "note": "board and momentum take countries_only (true to drop aggregates such as OECD, G20, EU). country takes country (ISO-3 code or name, required). meta takes no parameters. Growth figures are in percent; yoy is year-on-year, qoq is quarter-on-quarter, computed from the employment count. Quarterly data; a multi-hour protective cache fronts the OECD upstream.", "source": "OECD Quarterly National Accounts (DF_QNA_POP_EMPNC, total employment EMP) via OECD SDMX API, seasonally adjusted, live, keyless", "service": "employment-api", "economies": null, "endpoints": { "GET /v1/meta": "This document.", "GET /v1/board": "Economies ranked by year-on-year employment growth (countries_only optional).", "GET /v1/country": "One economy's employment growth, year-on-year and quarter-on-quarter (country=ESP).", "GET /v1/momentum": "Economies ranked by the latest quarter-on-quarter employment move." }, "description": "Employment growth — how fast the number of people in work is growing in each economy, live from the OECD's Quarterly National Accounts (no key). It computes the quarter-on-quarter and year-on-year growth of total employment from the OECD's seasonally-adjusted employment count. board ranks economies by year-on-year employment growth; momentum ranks by the latest quarter-on-quarter move; country gives one economy's figures with a plain-language read. The jobs …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/employment-api OpenAPI spec: https://www.oanor.com/api/employment-api/openapi.json