Inflation API

The Inflation API provides current economic inflation data for 38 major countries. The stats are usually updated monthly - although certain countries may lag behind or update more infrequently.

/v1/inflation

HTTP GET

Returns current monthly and annual inflation percentages.

The following inflation measures are available:

Consumer Price Index (CPI)

  • Austria

  • Belgium

  • Brazil premium only

  • Canada

  • Chile

  • China premium only

  • Czech Republic premium only

  • Denmark premium only

  • Estonia

  • Finland premium only

  • France premium only

  • Germany

  • Greece premium only

  • Hungary

  • Iceland

  • India premium only

  • Indonesia premium only

  • Ireland

  • Israel premium only

  • Italy premium only

  • Japan premium only

  • Mexico

  • Norway

  • Poland premium only

  • Portugal

  • Russia

  • Slovakia

  • Slovenia premium only

  • South Korea premium only

  • South Africa premium only

  • Spain premium only

  • Sweden

  • Switzerland

  • The Netherlands

  • Türkiye premium only

  • United Kingdom premium only

  • United States premium only


Harmonised Index of Consumer Prices (HICP)

  • Europe premium only

  • Austria

  • Belgium

  • Czech Republic premium only

  • Denmark premium only

  • Estonia

  • Finland

  • France premium only

  • Germany

  • Greece premium only

  • Hungary

  • Iceland

  • Ireland

  • Italy premium only

  • Poland premium only

  • Portugal

  • Slovakia

  • Slovenia

  • Spain premium only

  • Sweden

  • Switzerland

  • The Netherlands premium only

  • Türkiye premium only

  • United Kingdom premium only

Parameters

type (optional) - inflation indicator type. Can be either CPI (Consumer Price Index) or HICP (Harmonized Index of Consumer Prices). If not provided, the CPI will be used by default.

country (optional) - name of country (case-insensitive).

Headers

X-Api-Key (required) - API Key associated with your account.

Sample Request URL

Live Demo!

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

Sample Response

[
  {
    "country": "Canada",
    "type": "CPI",
    "period": "Oct 2023",
    "monthly_rate_pct": 0.06,
    "yearly_rate_pct": 3.12
  }
]

import requests

country = 'Canada'
api_url = 'https://api.api-ninjas.com/v1/inflation?country={}'.format(country)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
    print(response.text)
else:
    print("Error:", response.status_code, response.text)
var country = 'Canada'
$.ajax({
    method: 'GET',
    url: 'https://api.api-ninjas.com/v1/inflation?country=' + country,
    headers: { 'X-Api-Key': 'YOUR_API_KEY'},
    contentType: 'application/json',
    success: function(result) {
        console.log(result);
    },
    error: function ajaxError(jqXHR) {
        console.error('Error: ', jqXHR.responseText);
    }
});
const request = require('request');

var country = 'Canada'
request.get({
  url: 'https://api.api-ninjas.com/v1/inflation?country=' + country,
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
}, function(error, response, body) {
  if(error) return console.error('Request failed:', error);
  else if(response.statusCode != 200) return console.error('Error:', response.statusCode, body.toString('utf8'));
  else console.log(body)
});
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import com.fasterxml.jackson.databind.ObjectMapper;

URL url = new URL("https://api.api-ninjas.com/v1/inflation?country=Canada");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestProperty("accept", "application/json");
InputStream responseStream = connection.getInputStream();
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(responseStream);
System.out.println(root.path("fact").asText());
let url = URL(string: "https://api.api-ninjas.com/v1/inflation?country=Canada"!)!
var request = URLRequest(url: url)
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
    guard let data = data else { return }
    print(String(data: data, encoding: .utf8)!)
}
task.resume()
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.