Unemployment API
The Unemployment API provides historical, current, and projected future unemployment statistics about every country in the world.
From 4,745 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 402ms | 433ms | 463ms | 868ms | 1336ms |
Similar APIs
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
countryoptionalCountry name (case-insensitive) or 2-letter ISO-3166 alpha-2 code of the country. E.g.
CanadaorCA.yearoptionalYear for which to retrieve unemployment data.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
countryThe 3-letter ISO country code.
yearThe year for which the unemployment data is reported.
unemployment_rateThe unemployment rate as a percentage.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/unemployment?country=CanadaHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
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.
Frequently Asked Questions
Can I use the Unemployment API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Unemployment API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Unemployment API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Unemployment API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I query unemployment data for a specific country or year?
Call the/v1/unemploymentendpoint with at least one of thecountryoryearparameters. Thecountryvalue accepts a case-insensitive country name or 2-letter ISO-3166 alpha-2 code (e.g.CanadaorCA), andyearfilters the data to a single year. Sign up for a free API key to get started.What does the Unemployment API response include?
The API returns a JSON array of objects, each containingcountry(the 3-letter ISO country code),year(the reported year), andunemployment_rate(the unemployment rate as a percentage). See the error codes page for details on unsuccessful requests.What coverage does the Unemployment API provide?
It provides historical, current, and projected future unemployment statistics for every country in the world. To analyze it alongside other macroeconomic indicators, pair it with the GDP API, Inflation API, or Population API.What are some use cases for the Unemployment API?
It is useful for building economic dashboards, comparing labor-market trends across countries, and powering financial or research applications that trackunemployment_rateover time. Combine it with the Country API for richer per-country context, and review our pricing for higher request volumes.