Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Unemployment API

The Unemployment API provides historical, current, and projected future unemployment statistics about every country in the world.

(4.2)

From 4,745 users

1,800+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
402ms433ms463ms868ms1336ms

Didn't find what you were looking for? Suggest an improvement

/v1/unemployment GET

https://api.api-ninjas.com/v1/unemployment

Get unemployment data for a given country. Returns historical, current and forecast unemployment statistics.

Parameters

At least one of the following parameters must be set: country, year

  • country  optional

    Country name (case-insensitive) or 2-letter ISO-3166 alpha-2 code of the country. E.g. Canada or CA.

  • year  optional

    Year for which to retrieve unemployment data.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of unemployment data objects, each containing:

  • country

    The 3-letter ISO country code.

  • year

    The year for which the unemployment data is reported.

  • unemployment_rate

    The unemployment rate as a percentage.

Sample Request Live Demo!

country
year

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/unemployment?country=Canada

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 [ { "country": "CAN", "year": 1980, "unemployment_rate": 7.5 }, { "country": "CAN", "year": 1981, "unemployment_rate": 7.6 }, { "country": "CAN", "year": 1982, "unemployment_rate": 11.1 }, "..." ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/unemployment?country=United%20States" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.