Narwhal API
English
All APIs

Unemployment API

Official unemployment rates across ten countries.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "country": "USA",
  "period": "2026-07",
  "rate": "4.1",
  "unit": "percent",
  "released_on": "2026-08-07"
}

Endpoints

GETUnemployment/v1/economics/{country}/unemployment
country
One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period
Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_unemployment

API reference →
GETUnemployment history/v1/economics/{country}/unemployment/observations
country
One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
start
Inclusive first observation period.
end
Inclusive last observation period.
limit
Maximum observations returned. Defaults to 100.
cursor
The next_cursor from the previous page.

MCP · economics_get_unemployment_history

API reference →

History

cURL
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment/observations?start=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "observations": [
    {
      "country": "USA",
      "measure": "unemployment",
      "value": "4.1",
      "unit": "PCT",
      "transformation": "",
      "period": "2026-07"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

Sources and methodology

Explicit periods

Omit it for the latest accepted complete release, or pass one exact period.

REST and MCP

Use one API key for current and historical data through REST or MCP.

Coverage

View coverage →
AUS CAN DEU FRA GBR JPN MYS NLD SGP USA

Common questions

What does the response include?

Retrieve the official unemployment rate for one observation period.

Which periods can I request?

YYYY, YYYY-MM, or YYYY-QN

What coverage is available?

The observation frequency follows each official national release and can be monthly or quarterly across AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.

Make your first request

Get a free API key →