IMF World Economic Outlook Scraper — GDP & Inflation Data avatar

IMF World Economic Outlook Scraper — GDP & Inflation Data

Pricing

from $1.60 / 1,000 weo observations

Go to Apify Store
IMF World Economic Outlook Scraper — GDP & Inflation Data

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

Muhammad Afzal

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

21 days ago

Last modified

Features

Limited permissions

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.

FieldWhat it contains
entityCode, entityName, entityTypeIMF code (for example USA, WEOWORLD), name, and country, region or group
indicatorCode, indicatorNameWEO code and name, for example NGDP_RPCH / "Real GDP growth"
year, value, unitYear, numeric value and unit, for example "Annual percent change"
isProjection, projectionStartYearWhether the year is an IMF projection, and the first projected year for that indicator
source, vintage, datasetFor example "World Economic Outlook (October 2026)", October 2026, WEO
lastModifiedWhen the IMF last updated the indicator
sourceUrl, retrievedAtThe 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:

CodeIndicator
NGDP_RPCHReal GDP growth (annual percent change)
NGDPD, NGDPDPCGDP and GDP per capita, current prices (U.S. dollars)
PPPGDP, PPPPC, PPPSH, PPPEXGDP and GDP per capita at PPP, share of world GDP, implied PPP conversion rate
PCPIPCH, PCPIEPCHInflation, average and end-of-period consumer prices
LURUnemployment rate
LPPopulation (millions)
BCA, BCA_NGDPDCurrent account balance (U.S. dollars and percent of GDP)
GGXCNL_NGDP, GGXWDG_NGDPGeneral 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 ApifyClient
client = 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.

EventFREEBRONZESILVERGOLDPLATINUM / DIAMOND
WEO observation (one dataset row)USD 0.002001USD 0.00195USD 0.0019USD 0.0016USD 0.0016
Actor start (per started GB of allocated memory)USD 0.006251USD 0.006094USD 0.005938USD 0.005USD 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; vintage and lastModified tell 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.effectiveMaxResults shows 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.

Economic and public data from the same developer:

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