IMF DataMapper Scraper — GDP, Inflation & Debt by Country

Extract macroeconomic indicators from the IMF DataMapper (World Economic Outlook and other IMF databases) into clean, structured JSON. Pull GDP growth, inflation, government debt, unemployment, GDP per capita and 130+ other indicators for 190+ countries across any year range — including IMF forward projections.

This Actor turns the IMF's interactive DataMapper into a programmatic dataset for economic research, financial modeling, dashboards, and RAG pipelines. Every record is one country-year observation, enriched with the human-readable country name, indicator label, unit, and source.

Features

• 130+ indicators — real GDP growth, inflation, current account, gross debt, unemployment, population, and more.
• 190+ countries plus optional IMF regional aggregates (Advanced Economies, Euro Area, Emerging Markets).
• Any year range, including multi-year IMF projections.
• Enriched output — country names, indicator labels, and units resolved automatically (no cryptic codes).
• No API key required.

Output fields

Field	Description
countryName	Country or group name (e.g. "United States")
countryCode	ISO3 code (e.g. "USA")
indicator	IMF indicator code (e.g. "NGDP_RPCH")
indicatorLabel	Human-readable indicator name
year	Observation year
value	Numeric value of the indicator
unit	Unit of measure (e.g. "Annual percent change")
entityType	country or group
source	Source database (e.g. "World Economic Outlook")

How to scrape IMF economic data

1. Set the Indicator code — default is NGDP_RPCH (Real GDP growth). Browse all codes at the IMF DataMapper indicators endpoint.
2. (Optional) Restrict to specific countries by ISO3 code, e.g. USA,CHN,DEU,IND. Leave empty for all countries.
3. Set the start year and end year.
4. Click Start. Results stream into the dataset as country-year records you can export to JSON, CSV, or Excel.

Input example

{
  "indicator": "PCPIPCH",
  "countries": "USA,CHN,DEU,IND",
  "startYear": 2018,
  "endYear": 2026,
  "includeGroups": false,
  "maxResults": 20000
}

Output example

{
  "countryName": "United States",
  "countryCode": "USA",
  "indicator": "NGDP_RPCH",
  "indicatorLabel": "Real GDP growth",
  "year": 2024,
  "value": 2.8,
  "unit": "Annual percent change",
  "entityType": "country",
  "source": "World Economic Outlook"
}

Pricing

This Actor is billed per result (per country-year observation). A full multi-country, multi-year pull costs only a few cents of results plus Apify platform compute. Restrict countries or the year range to control volume.

Other scrapers you may like

• World Bank Indicators Scraper — development indicators by country.
• FRED Economic Data Scraper — U.S. Federal Reserve economic time series.
• Treasury Fiscal Data Scraper — U.S. federal debt and spending.
• BLS Labor Statistics Scraper — U.S. employment and price indexes.

FAQ

Do I need an IMF account or API key? No. The IMF DataMapper API is public and free.

Which indicators are available? Over 130, spanning GDP, prices, government finance, external sector, and demographics. See the indicators endpoint linked above.

Can I get forecasts? Yes — the IMF publishes multi-year projections; set endYear beyond the current year to include them.

How fresh is the data? The DataMapper is updated with each IMF World Economic Outlook release (typically April and October).

Legal

This Actor extracts publicly available, non-personal statistical data published by the International Monetary Fund. Use the data in accordance with the IMF's terms. This tool is provided for research and analytical purposes.