Inflation API

Frequently Asked Questions

• Can I use the Inflation API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the Inflation 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 Inflation API?

  Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header 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 Inflation 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.

• What countries and inflation indicators does the Inflation API cover?

  The API provides inflation data for 38 major countries, including the United States, Canada, Japan, Germany, the United Kingdom and many others, identified by their 2-letter ISO-3166-1 alpha-2 code. It supports two indicator types via the type parameter: CPI (Consumer Price Index, available for all countries) and HICP (Harmonized Index of Consumer Prices, available for many European countries). To compare other macroeconomic indicators, see our GDP API and Unemployment API.

• How do I query inflation for a specific country?

  Call the /v1/inflation endpoint with the country parameter, which accepts either a 2-letter ISO-3166-1 alpha-2 code (e.g. US) or the case-insensitive country name (e.g. United States), and optionally a type of CPI or HICP (defaults to CPI). Both endpoints are Premium only, so you will need a paid plan from our pricing page.

• What does the /v1/inflation response include?

  It returns a JSON array of objects, each with country, country_code, type (CPI or HICP), period, monthly_rate_pct, and yearly_rate_pct fields. The stats are usually updated monthly, though some countries may lag behind; if a request is unsuccessful you will receive an error instead.

• How do I retrieve historical inflation rates?

  Use the /v1/inflationhistorical endpoint with the required country parameter and optional type, start_time, and end_time parameters (the latter two as UNIX timestamps in seconds). It returns a JSON object whose data array holds up to 100 points, each with a timestamp and rate_pct; explore all our finance endpoints on the APIs page.