📊 IMF Data Scraper

🚀 Export IMF economic indicators for 190+ countries in seconds. GDP growth, inflation, unemployment, government debt - all from the IMF World Economic Outlook, zero configuration required.

🕒 Last updated: 2026-05-21 · 📊 11 fields per record · 190+ countries · Annual frequency

The IMF Data Scraper extracts time series data from the International Monetary Fund's public World Economic Outlook (WEO) API. No API key required - the IMF provides this data freely. Every record includes the indicator code, human-readable name, country, year, value, unit, and scrape timestamp.

Coverage spans the full WEO dataset: GDP, inflation, unemployment, current account, government debt, PPP conversion rates, and more, for every IMF member country from 1980 through present with forecasts to 2031.

Target Audience / Use Cases

Who	Why
Economists & analysts	Track macroeconomic trends across countries
Journalists	Research and fact-check economic data
Data scientists	Build models with clean, structured IMF data
Investors	Monitor macro indicators for market research
Academic researchers	Comparative country studies
Developers	Integrate IMF data into dashboards and apps

📋 What the IMF Data Scraper does

• Selects from 9 World Economic Outlook indicators including CPI inflation, GDP growth, unemployment, and government debt
• Accepts any combination of ISO 2-letter country codes for precise country selection
• Filters by start and end year (1980 to 2031 including forecasts)
• Respects maxItems for controlled data extraction
• Returns clean structured records with no null fields for the supported indicators
• Exports to CSV, Excel, JSON, and XML in one click

💡 Why it matters: The IMF WEO is one of the most authoritative macroeconomic datasets in the world, updated twice yearly. Getting this data in a spreadsheet previously required manual downloads from the IMF website. This actor delivers it in seconds.

🎬 Full Demo

🚧 Coming soon

⚙️ Input

Field	Type	Required	Default	Description
indicator	select	Yes	PCPIPCH	IMF WEO indicator to retrieve
countryCodes	array	No	Top 10 economies	ISO 2-letter codes, e.g. ["US","GB","DE"]
startYear	integer	No	2010	Earliest year (minimum 1980)
endYear	integer	No	2023	Latest year
maxItems	integer	No	10	Max records to return

Available indicators:

Code	Name	Unit
PCPIPCH	Inflation Rate, Average Consumer Prices	Annual percent change
NGDP_RPCH	Real GDP Growth Rate	Annual percent change
NGDPD	GDP, Current Prices	Billions of USD
BCA_NGDPD	Current Account Balance	Percent of GDP
LUR	Unemployment Rate	Percent
GGXWDG_NGDP	General Government Gross Debt	Percent of GDP
GGXCNL_NGDP	Government Net Lending/Borrowing	Percent of GDP
NGDPDPC	GDP Per Capita, Current Prices	USD per capita
PPPEX	Implied PPP Conversion Rate	National currency per international dollar

Example 1 - CPI inflation for G7 countries (2015-2023):

{
  "indicator": "PCPIPCH",
  "countryCodes": ["US", "GB", "DE", "JP", "FR", "IT", "CA"],
  "startYear": 2015,
  "endYear": 2023,
  "maxItems": 100
}

Example 2 - Government debt for emerging markets:

{
  "indicator": "GGXWDG_NGDP",
  "countryCodes": ["IN", "BR", "MX", "ZA", "TR", "AR", "ID"],
  "startYear": 2010,
  "endYear": 2023,
  "maxItems": 200
}

⚠️ Good to Know: Free users are limited to 10 items per run. Upgrade to a paid plan for up to 1,000,000 items. The actor uses the IMF World Economic Outlook public API which includes historical data from 1980 and WEO forecasts through 2031.

📊 Output

Field	Type	Description
📊 indicator	string	IMF indicator code (e.g. PCPIPCH)
📈 indicatorName	string	Human-readable indicator name
🌍 country	string	Country name
🏳️ countryCode	string	ISO 2-letter country code
📅 year	string	Year of observation
💹 value	number	Numeric value for the indicator
📐 unit	string	Unit of measurement
🔁 frequency	string	Data frequency (Annual)
🔗 url	string	IMF DataMapper URL for this indicator
🕒 scrapedAt	string	ISO timestamp of extraction
❌ error	string	Error message if extraction failed

Sample records (CPI inflation, 2022):

[
  {
    "indicator": "PCPIPCH",
    "indicatorName": "Inflation Rate, Average Consumer Prices",
    "country": "United States",
    "countryCode": "US",
    "year": "2022",
    "value": 8,
    "unit": "Annual percent change",
    "frequency": "Annual",
    "url": "https://www.imf.org/external/datamapper/PCPIPCH",
    "scrapedAt": "2026-05-22T00:55:04.773Z",
    "error": null
  },
  {
    "indicator": "PCPIPCH",
    "indicatorName": "Inflation Rate, Average Consumer Prices",
    "country": "United Kingdom",
    "countryCode": "GB",
    "year": "2022",
    "value": 7.9,
    "unit": "Annual percent change",
    "frequency": "Annual",
    "url": "https://www.imf.org/external/datamapper/PCPIPCH",
    "scrapedAt": "2026-05-22T00:55:04.773Z",
    "error": null
  },
  {
    "indicator": "PCPIPCH",
    "indicatorName": "Inflation Rate, Average Consumer Prices",
    "country": "China, People's Republic of",
    "countryCode": "CN",
    "year": "2022",
    "value": 2,
    "unit": "Annual percent change",
    "frequency": "Annual",
    "url": "https://www.imf.org/external/datamapper/PCPIPCH",
    "scrapedAt": "2026-05-22T00:55:04.773Z",
    "error": null
  }
]

✨ Why choose this Actor

Feature	Benefit
🌐 No API key required	Zero setup - just run
📡 Direct IMF WEO source	Official, authoritative data
🕰️ 1980-2031 coverage	Historical + WEO forecasts
🌍 190+ countries	Every IMF member nation
📊 9 key indicators	GDP, inflation, debt, unemployment
🚀 Runs in seconds	Fast API-first implementation
📤 CSV/Excel/JSON/XML	Instant export in any format
🆓 Free tier available	10 items per run, no credit card

📈 How it compares to alternatives

Method	Speed	Data Quality	Ease of Use
IMF Data Scraper (this)	Seconds	Official WEO	One-click
Manual IMF website download	Minutes	Official	Requires navigation
IMF SDMX API (raw)	Seconds	Official	Complex XML/JSON
World Bank scraper	Seconds	World Bank	Different coverage
Custom Python script	Hours to build	Varies	Requires coding

🚀 How to use

1. Create a free Apify account - includes $5 credit
2. Open the IMF Data Scraper actor page
3. Select an indicator from the dropdown (e.g. "Inflation Rate, Average Consumer Prices")
4. Enter country codes (e.g. ["US","GB","DE","JP","CN"]) or leave empty for top 20 economies
5. Set the year range (default 2010-2023)
6. Click Start and wait a few seconds
7. Download your dataset as CSV, Excel, JSON, or XML

💼 Business use cases

Macroeconomic Research

Compare inflation trajectories across countries during the 2021-2023 global inflation surge. Pull PCPIPCH for all 190+ countries in a single run, export to Excel, and chart side-by-side. Identify outliers - countries with inflation above 20% or below 0% - for deeper research.

Investment and Portfolio Analysis

Monitor government debt-to-GDP ratios (GGXWDG_NGDP) across emerging markets. Run monthly to track fiscal deterioration. Combine with GDP growth (NGDP_RPCH) to identify countries with high debt but low growth as sovereign risk flags.

Policy and Advocacy

Track unemployment rates (LUR) across a custom list of countries for policy reports. Export the time series as a chart-ready CSV and compare pre/post policy intervention periods. The WEO forecasts extend through 2031 for forward-looking analysis.

Competitive Intelligence

Monitor economic conditions in target markets. Pull GDP per capita (NGDPDPC) and PPP conversion rates (PPPEX) for markets where your company operates or plans to expand. Build an automated data pipeline using Apify's scheduling feature.

🔌 Automating IMF Data Scraper

The actor integrates with automation platforms via Apify's webhooks and API:

• Make (formerly Integromat) - Trigger on schedule, route data to Google Sheets or Airtable
• Zapier - Connect to 5,000+ apps, push IMF data to Slack channels or databases
• Slack - Post macro indicator summaries to team channels after each run
• Google Sheets - Append new records directly to a live spreadsheet via Make/Zapier
• REST API - Use Apify's API to trigger runs and fetch results programmatically

Example cron: run weekly on Mondays to track the latest WEO updates.

🌟 Beyond business use cases

Academic Research

• Cross-country growth regressions using IMF GDP and investment data
• Debt sustainability analysis for developing economies
• Inflation dynamics research post-COVID-19

Data Journalism

• Fact-check claims about inflation, unemployment, or government debt
• Create interactive charts backed by authoritative IMF data
• Track how WEO forecasts change edition-to-edition

Personal Finance and Investing

• Monitor inflation trends in countries you hold currency or assets in
• Track PPP exchange rates for international purchasing power comparison
• Follow government debt trends in bond markets you follow

Education and Classroom

• Economics teachers can assign country analysis projects using real IMF data
• Students learn to interpret macroeconomic indicators using live datasets
• Ideal for development economics, international finance courses

🤖 Ask an AI assistant about this scraper

Not sure which indicator to use or how to structure your analysis? Ask Claude, ChatGPT, or any AI assistant:

"I want to compare inflation across G20 countries from 2015 to 2023 using the IMF Data Scraper. What indicator code should I use and how do I structure the input?"

The actor's output is structured and clean - perfect for feeding directly into AI analysis workflows.

❓ Frequently Asked Questions

🔑 Do I need an API key for the IMF? No. The IMF World Economic Outlook data is completely public. The actor accesses it without any authentication.

📅 How current is the data? The WEO is updated twice yearly (April and October). The actor always fetches the latest available data. As of this writing, April 2026 data is available.

🔮 Does it include forecasts? Yes. WEO data extends through 2031 with IMF projections. Set your endYear beyond the current year to include forecasts.

🌍 Which countries are covered? All 190 IMF member countries. Use ISO 2-letter country codes (US, GB, DE, CN, etc.) or leave the field empty to get all countries.

📊 Which indicators are available? The actor exposes 9 key WEO indicators. The full WEO dataset has many more - if you need a specific indicator not listed, contact ParseForge.

💾 What export formats are supported? CSV, Excel (.xlsx), JSON, and XML - all built into Apify's dataset viewer.

🔁 Can I run this on a schedule? Yes. Apify supports cron-based scheduling. Set up a weekly or monthly run to track evolving WEO data.

🔢 What is the maximum number of records? Paid users can retrieve up to 1,000,000 records. A full run (all countries, all indicators, all years) for one indicator yields approximately 190 countries x 50 years = ~9,500 records.

⏱️ How long does a run take? Typically 3-5 seconds. The IMF API is fast and the actor makes a single HTTP request per run.

📈 How do I estimate run time for 100 items? For 100 records: approximately 3-5 seconds total. The bottleneck is the single API call, not parsing.

🔌 Integrate with any app

Apify supports native integrations with: Make, Zapier, Slack, Google Sheets, Airtable, Notion, Salesforce, HubSpot, Webhooks, REST API, Python SDK, JavaScript SDK, and more.

🔗 Recommended Actors

Actor	Description
World Bank Scraper	World Bank development indicators, GDP, poverty data
BLS Data Scraper	US Bureau of Labor Statistics - CPI, unemployment, wages
Exchange Rate Scraper	Live exchange rates for 170+ currencies

💡 Pro Tip: browse the complete ParseForge collection for 90+ public data scrapers covering finance, economics, real estate, and more.

---

Disclaimer: This actor scrapes publicly available data from the International Monetary Fund's World Economic Outlook API. All data is sourced from www.imf.org. Use of this data is subject to IMF's terms of service. ParseForge is not affiliated with the IMF. Data accuracy depends on the IMF's own figures and forecast methodology.