Inflation Tracker API

Track inflation and consumer price index data from World Bank indicators across countries and years. Collect country-level inflation values for a single year, a historical date range, or the complete dataset since 1960. Built for analysts, researchers, dashboards, and economic monitoring workflows.

---

Features

• Flexible input modes - Use a World Bank URL, keyword, or indicator code with optional country and date filters.
• Historical data mode - Fetch data for any year range from 1960 to the present day.
• Complete dataset mode - Enable fetchAllData to retrieve the entire World Bank history in a single fast API call.
• Global or country-level tracking - Collect records for all countries or selected ISO codes.
• Concurrent page fetching - Multiple API pages are fetched in parallel for maximum speed.
• Indicator metadata - Each record includes source database, methodological notes, source organization, and topic categories.
• Clean dataset output - Records are stored without null or empty fields.
• Ready for automation - Works with schedules, webhooks, and downstream BI pipelines.

---

Use Cases

Economic Monitoring

Track inflation changes across countries and monitor macroeconomic pressure in near real-time.

Historical Analysis

Retrieve decades of inflation data to identify long-term trends, turning points, and economic cycles.

Market Expansion Research

Compare inflation trends across candidate regions before launching products or adjusting pricing strategy.

Investment and Risk Analysis

Use country-level inflation values as an input signal for portfolio allocation, country scoring, and risk models.

Academic and Policy Research

Build reproducible inflation datasets for policy briefs, classroom projects, and econometrics studies.

---

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	"https://data.worldbank.org/indicator/FP.CPI.TOTL.ZG?year=2024"	Optional World Bank URL. Year and country are extracted automatically.
location	String	No	"all"	Country filter using ISO code(s), for example USA or USA,CAN,PAK.
date_from	Integer	No	—	Start year for historical data (e.g. 1990). Leave empty to use URL year or default to current year.
date_to	Integer	No	—	End year for historical data (e.g. 2024). Leave empty to use current year.
fetchAllData	Boolean	No	false	When enabled, fetches all available years (complete history since 1960). Overrides date range.
results_wanted	Integer	No	20	Maximum number of records to return. Ignored when fetchAllData is enabled.
max_pages	Integer	No	10	Maximum number of API pages to fetch. Each page holds up to 20,000 records.
proxyConfiguration	Object	No	{ "useApifyProxy": false }	Optional proxy settings for controlled network routing.

---

Output Data

Each item in the dataset can contain:

Field	Type	Description
indicator_id	String	World Bank indicator code.
indicator_name	String	Human-readable indicator name.
country_id	String	Country identifier from source.
country_name	String	Country or economy name.
country_iso3	String	ISO3 country code.
year	Number	Observation year.
inflation_rate	Number	Annual inflation rate percentage.
obs_status	String	Observation status flag.
decimal_places	Number	Suggested decimal precision.
source_database	String	World Bank database name for the indicator.
source_note	String	Methodological description of how the indicator is measured.
source_organization	String	Organization that originally provided the data.
topics	String	Comma-separated topic categories.
source_url	String	API endpoint URL used to retrieve this record.

---

Usage Examples

Basic Run With URL

{
	"url": "https://data.worldbank.org/indicator/FP.CPI.TOTL.ZG?year=2024",
	"results_wanted": 20
}

Keyword and Global Scope

{
	"location": "all",
	"results_wanted": 50,
	"max_pages": 5
}

Multi-Country Run

{
	"location": "USA,CAN,PAK",
	"results_wanted": 30,
	"max_pages": 3
}

Historical Date Range

{
	"location": "USA,GBR",
	"date_from": 1990,
	"date_to": 2000,
	"results_wanted": 100
}

Complete History for One Country

{
	"location": "PAK",
	"fetchAllData": true
}

All Countries, All Years

{
	"location": "all",
	"fetchAllData": true,
	"max_pages": 5
}

---

Sample Output

{
	"indicator_id": "FP.CPI.TOTL.ZG",
	"indicator_name": "Inflation, consumer prices (annual %)",
	"country_id": "GB",
	"country_name": "United Kingdom",
	"country_iso3": "GBR",
	"year": 2000,
	"inflation_rate": 1.18295624210408,
	"decimal_places": 1,
	"source_database": "World Development Indicators",
	"source_note": "Inflation as measured by the consumer price index reflects the annual percentage change in the cost to the average consumer of acquiring a basket of goods and services...",
	"source_organization": "International Financial Statistics database, International Monetary Fund (IMF)",
	"topics": "Economy & Growth, Financial Sector",
	"source_url": "https://api.worldbank.org/v2/country/USA%3BGBR/indicator/FP.CPI.TOTL.ZG?format=json&date=1990%3A2000&page=1&per_page=50"
}

---

Tips for Best Results

Start Small First

• Begin with results_wanted: 20 to validate your configuration quickly.
• Increase limits only after confirming the expected output structure.

Use ISO Codes for Precise Filters

• Use uppercase country codes such as USA or PAK for targeted results.
• For multiple countries, use comma-separated values.

Historical Data

• Use date_from and date_to for a specific year window.
• Set fetchAllData: true to get the full history for any country or globally.
• The World Bank database goes back to 1960 for most indicators.

Keep Pagination Intentional

• Each API page holds up to 20,000 records, so most requests complete in a single page.
• Set max_pages according to your expected dataset size.

---

Proxy Configuration

{
	"proxyConfiguration": {
		"useApifyProxy": true,
		"apifyProxyGroups": ["RESIDENTIAL"]
	}
}

---

Integrations

• Google Sheets - Share inflation snapshots with teams.
• Airtable - Build searchable economic intelligence tables.
• Looker Studio - Visualize country-level inflation trends.
• Power BI - Merge inflation data with internal business metrics.
• Webhooks - Push fresh records into your own systems.
• Make / Zapier - Trigger alerts and no-code automations.

Export formats supported by Apify include JSON, CSV, Excel, and XML.

---

Frequently Asked Questions

Can I run this actor without a URL?

Yes. You can use keyword and location only.

What location format should I use?

Use all for global data or ISO codes like USA and CAN.

Why are some rows missing fields?

The actor excludes null and empty values from output, so only meaningful fields are stored.

How can I get more records?

Increase results_wanted and optionally increase max_pages.

Is this suitable for scheduled monitoring?

Yes. It is designed to run repeatedly and feed automated dashboards.

---

Support

For issues or feature requests, open a discussion in your Apify Console actor page.

---

Legal Notice

This actor is intended for legitimate data collection and analysis. Users are responsible for compliance with applicable laws, policies, and data usage terms.