IMF World Economic Outlook Scraper — GDP & Inflation Data
Pricing
from $1.60 / 1,000 weo observations
IMF World Economic Outlook Scraper — GDP & Inflation Data
Export IMF World Economic Outlook data by country, region and year: GDP growth, inflation, debt, unemployment and projections. USD 2 per 1,000 rows.
Pricing
from $1.60 / 1,000 weo observations
Rating
0.0
(0)
Developer
Muhammad Afzal
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
21 days ago
Last modified
Categories
Features
Share
IMF World Economic Outlook Scraper exports IMF World Economic Outlook (WEO) data as one row per country, indicator and year, covering real GDP growth, GDP in dollars and PPP, GDP per capita, inflation, unemployment, population, current account and government debt, with each IMF projection flagged. It is built for economists, analysts, investors, students and AI agents who need WEO figures in a spreadsheet or pipeline, and it costs USD 2.00 per 1,000 observations on the FREE tier (USD 1.60 per 1,000 on GOLD).
The data comes from the IMF's public DataMapper service for the WEO dataset. On 2026-10-26 the current vintage was the October 2026 World Economic Outlook (last modified 2026-10-08). No API key is needed.
What data does the IMF World Economic Outlook scraper return?
Each dataset row is one observation: one entity, one indicator, one year. Missing IMF values are left out rather than written as zero.
| Field | What it contains |
|---|---|
entityCode, entityName, entityType | IMF code (for example USA, WEOWORLD), name, and country, region or group |
indicatorCode, indicatorName | WEO code and name, for example NGDP_RPCH / "Real GDP growth" |
year, value, unit | Year, numeric value and unit, for example "Annual percent change" |
isProjection, projectionStartYear | Whether the year is an IMF projection, and the first projected year for that indicator |
source, vintage, dataset | For example "World Economic Outlook (October 2026)", October 2026, WEO |
lastModified | When the IMF last updated the indicator |
sourceUrl, retrievedAt | The IMF endpoint used and retrieval time |
The OUTPUT record reports DATA, EMPTY, REJECTED or FAILED, the delivered count, the normalized input and any diagnostics.
Which WEO indicators and countries can I download?
All 15 indicators that the IMF publishes for the WEO dataset in DataMapper:
| Code | Indicator |
|---|---|
NGDP_RPCH | Real GDP growth (annual percent change) |
NGDPD, NGDPDPC | GDP and GDP per capita, current prices (U.S. dollars) |
PPPGDP, PPPPC, PPPSH, PPPEX | GDP and GDP per capita at PPP, share of world GDP, implied PPP conversion rate |
PCPIPCH, PCPIEPCH | Inflation, average and end-of-period consumer prices |
LUR | Unemployment rate |
LP | Population (millions) |
BCA, BCA_NGDPD | Current account balance (U.S. dollars and percent of GDP) |
GGXCNL_NGDP, GGXWDG_NGDP | General government net lending/borrowing and gross debt (percent of GDP) |
Entities use IMF codes: countries such as USA, CHN, DEU, IND, JPN or PAK, IMF regions, and analytical groups such as WEOWORLD (world) or ADVEC (advanced economies). An unknown code stops the run before any data is written, with a message listing the bad codes and no result charges. This is the DataMapper selection of key WEO indicators, not the full WEO database file with every series.
How do I get IMF GDP growth and inflation forecasts by country?
List the countries and indicators and pick a year range. Projections are included by default:
{"entityCodes": ["USA", "CHN", "IND", "DEU", "WEOWORLD"],"indicatorCodes": ["NGDP_RPCH", "PCPIPCH", "GGXWDG_NGDP"],"startYear": 2020,"endYear": 2031,"includeProjections": true,"maxResults": 500}
For historical data only, set includeProjections to false; years from each indicator's projection start year onward are then dropped. Series in DataMapper generally start in 1980. Up to 100 entities, 20 indicators and a 100-year range fit in one run, with maxResults up to 50,000 rows (default 100).
When should I use this Actor, and when not?
Use it when you need IMF WEO numbers as data: comparing growth and inflation forecasts across countries, refreshing a macro dashboard after each April and October WEO release, building country-risk models, or giving an AI agent a tool that returns the latest IMF projections.
Use another Actor when:
- You need U.S. time series such as Treasury yields, CPI by month or unemployment by month: FRED Data Scraper.
- You need U.S. Census tables: US Census Bureau Data API Scraper.
- You need quarterly or monthly figures, past WEO vintages, or the full WEO database file. This Actor returns annual values from the current vintage only.
Use it from an AI assistant
IMF World Economic Outlook Scraper works from Claude, ChatGPT, Cursor or any MCP client through Apify's MCP server. Add it with https://mcp.apify.com/?tools=muhammadafzal/imf-world-economic-outlook-scraper, then ask, for example: "Compare the IMF's latest real GDP growth forecasts for the G7 countries for 2026 and 2027."
Run it with the API
JavaScript:
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: process.env.APIFY_TOKEN });const run = await client.actor('muhammadafzal/imf-world-economic-outlook-scraper').call({entityCodes: ['USA', 'CHN'],indicatorCodes: ['NGDP_RPCH', 'PCPIPCH'],startYear: 2024,endYear: 2027,includeProjections: true,maxResults: 100,});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items.map((i) => `${i.entityCode} ${i.indicatorCode} ${i.year}: ${i.value}`));
Python:
from apify_client import ApifyClientclient = ApifyClient("YOUR_APIFY_TOKEN")run = client.actor("muhammadafzal/imf-world-economic-outlook-scraper").call(run_input={"entityCodes": ["JPN", "GBR"], "indicatorCodes": ["LUR", "GGXWDG_NGDP"], "startYear": 2015, "endYear": 2030})for obs in client.dataset(run.default_dataset_id).iterate_items():print(obs["entityName"], obs["indicatorName"], obs["year"], obs["value"], obs["isProjection"])
What does the output look like?
Two records from the default run on 2026-10-26 (one actual, one projected):
[{"entityCode": "CHN","entityName": "China, People's Republic of","entityType": "country","indicatorCode": "NGDP_RPCH","indicatorName": "Real GDP growth","year": 2025,"value": 5,"unit": "Annual percent change","isProjection": false,"projectionStartYear": 2026,"source": "World Economic Outlook (October 2026)","dataset": "WEO","vintage": "October 2026","lastModified": "2026-10-08 14:43:32","sourceUrl": "https://www.imf.org/external/datamapper/api/v2/NGDP_RPCH","retrievedAt": "2026-10-26T07:21:11.603Z"},{"entityCode": "USA","entityName": "United States","entityType": "country","indicatorCode": "PCPIPCH","indicatorName": "Inflation rate, average consumer prices","year": 2026,"value": 3.6,"unit": "Annual percent change","isProjection": true,"projectionStartYear": 2026,"source": "World Economic Outlook (October 2026)","dataset": "WEO","vintage": "October 2026","lastModified": "2026-10-08 14:43:36","sourceUrl": "https://www.imf.org/external/datamapper/api/v2/PCPIPCH","retrievedAt": "2026-10-26T07:21:11.603Z"}]
Pricing: how much does IMF WEO data cost?
IMF World Economic Outlook Scraper uses pay-per-event pricing. Platform usage is included in the event prices.
| Event | FREE | BRONZE | SILVER | GOLD | PLATINUM / DIAMOND |
|---|---|---|---|---|---|
| WEO observation (one dataset row) | USD 0.002001 | USD 0.00195 | USD 0.0019 | USD 0.0016 | USD 0.0016 |
| Actor start (per started GB of allocated memory) | USD 0.006251 | USD 0.006094 | USD 0.005938 | USD 0.005 | USD 0.005 |
Worked totals on the FREE tier at the default 256 MB memory (one start event):
- Default run, 16 observations (2 countries × 2 indicators × 4 years): 16 × USD 0.002001 + USD 0.006251 = USD 0.0383
- 1,000 observations: 1,000 × USD 0.002001 + USD 0.006251 = USD 2.0073
Rejected input and searches with no matching values charge only the start fee. Set a maximum cost per run in Apify Console to cap spending.
What are the limits?
- Annual data from the current WEO vintage. The IMF revises WEO twice a year (April and October), so values change between releases;
vintageandlastModifiedtell you which one you have. - Missing values are skipped, so some entity-year combinations return no row.
- Speed. The default run finished in about 4 seconds. Each indicator is one request, retried up to 3 times on errors or rate limits.
- Entity filtering is local. The IMF endpoint can return more series than requested; the Actor keeps only your entities and years.
- Maximum cost per run. The Actor reserves the start fee, then stops at the number of rows your limit can pay for at the live price;
OUTPUT.effectiveMaxResultsshows that number.
FAQ
Is this official IMF data?
Yes. Every value comes from the IMF's public DataMapper service for the World Economic Outlook dataset, and each row records the source endpoint and vintage.
When is the World Economic Outlook updated?
The IMF publishes the full WEO in April and October, with interim updates in between. Run the Actor after a release to get the new vintage.
How do I tell forecasts from actual data?
Use isProjection. It is true from the indicator's projectionStartYear onward (2026 for the October 2026 vintage).
Can I get regional and world aggregates?
Yes. Use IMF group codes such as WEOWORLD (world), ADVEC (advanced economies) or EURO (euro area), or an IMF region code. Their rows have entityType group or region.
Does it cover other IMF datasets?
No. It returns WEO indicators only. Other DataMapper datasets (fiscal monitor series, for example) are filtered out.
Do I need an IMF account or API key?
No. The IMF DataMapper service is public.
Related Actors
Economic and public data from the same developer:
- FRED Data Scraper for U.S. economic time series
- FDA Drug Approvals Scraper for Drugs@FDA approval history
- ProPublica Nonprofit Explorer Scraper for nonprofit 990 data
- IDFPR License Lookup for Illinois professional licenses
- US Census Bureau Data API Scraper for U.S. demographic data
Legal and compliance
This Actor reads public IMF data and is not affiliated with or endorsed by the International Monetary Fund. It does not log in or bypass access controls. Use and cite the data according to the IMF Copyright and Usage terms. WEO projections are IMF staff estimates, not guarantees.
Last verified: 2026-10-27