IMF World Economic Outlook Scraper

Extract current macroeconomic observations from the official IMF World Economic Outlook (WEO) DataMapper API. The Actor returns one clean dataset item per entity, indicator, and year, ready for research, dashboards, spreadsheets, and AI agents.

What you can extract

• Countries such as USA, CHN, DEU, IND, and PAK
• IMF regions and analytical groups such as WEOWORLD
• Real GDP growth (NGDP_RPCH)
• Nominal GDP (NGDPD) and GDP per capita (NGDPDPC)
• Average inflation (PCPIPCH)
• Unemployment (LUR)
• Current account balance (BCA_NGDPD)
• Government net lending/borrowing (GGXCNL_NGDP)
• Government gross debt (GGXWDG_NGDP)

The DataMapper WEO surface contains selected key indicators. It is not the full spreadsheet/SDMX WEO database.

Free-plan result limit

Verified Apify free-plan runs return at most 5 business records per run, even if maxResults is higher. Upgrade your Apify plan to request more than five records in one run; paid users retain the requested maxResults cap.

Input example

{
  "entityCodes": ["USA", "CHN", "WEOWORLD"],
  "indicatorCodes": ["NGDP_RPCH", "PCPIPCH"],
  "startYear": 2024,
  "endYear": 2027,
  "includeProjections": true,
  "maxResults": 100
}

Output example

{
  "entityCode": "USA",
  "entityName": "United States",
  "entityType": "country",
  "indicatorCode": "NGDP_RPCH",
  "indicatorName": "Real GDP growth",
  "year": 2026,
  "value": 2.3,
  "unit": "Annual percent change",
  "isProjection": true,
  "projectionStartYear": 2026,
  "source": "World Economic Outlook (April 2026)",
  "dataset": "WEO",
  "vintage": "April 2026",
  "lastModified": "2026-04-08 16:07:34",
  "sourceUrl": "https://www.imf.org/external/datamapper/api/v2/NGDP_RPCH",
  "retrievedAt": "2026-08-27T00:00:00.000Z"
}

Projection handling

The IMF metadata declares a projection start year per indicator. isProjection is true from that year onward. Set includeProjections to false to exclude those records. Missing IMF values are omitted rather than converted to zero.

Pricing

This Actor uses pay-per-event pricing. These are the current Apify Store event prices:

Event	Price (USD)	When it is charged
apify-default-dataset-item	$0.0005	WEO observation — Charged automatically for each normalized IMF WEO entity-indicator-year observation written to the default dataset.
apify-actor-start	$0.00005	Actor Start — Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). — Charged once per run.

Apify platform usage for this Actor run is included alongside the event prices above; no separate per-run platform-usage fee is passed to users.

This covers Apify platform usage for this Actor run. Other Apify products or usage outside this Actor run may still follow your account plan.

Reliability and limitations

• Data comes directly from the public IMF DataMapper v2 endpoint; no API key or proxy is required.
• The official API currently may return more series than requested, so the Actor applies entity and year filtering locally.
• WEO is revised twice yearly, and the Actor reports the source vintage and last-modified metadata returned by IMF.
• Some entities or years have no value for a selected indicator.
• WEO projections are IMF staff estimates and are not guarantees.
• Use IMF data in accordance with the IMF Copyright and Usage terms.

Run diagnostics

The default dataset contains only homogeneous WEO observations. OUTPUT in the default key-value store reports DATA, EMPTY, REJECTED, or FAILED, delivered counts, normalized input, source details, and actionable diagnostics. Invalid entity or indicator codes produce no fabricated records and no result-event charges.

Local development

npm install
npm test
apify run

This Actor is an independent data extraction tool and is not affiliated with or endorsed by the International Monetary Fund.

Use cases

• Schedule repeatable collection and export results to downstream workflows.
• Run a one-off research job and export the structured result as JSON, CSV, Excel, XML, or RSS from Apify.
• Schedule the same input to monitor changes over time and send completed datasets to a webhook or integration.
• Feed schema-shaped records into a database, spreadsheet, BI tool, or AI workflow with the source URL retained for verification.

Run IMF World Economic Outlook Scraper with the Apify API

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);

You can also run the Actor from Apify Console, schedules, webhooks, the REST API, Make, Zapier, n8n, or the hosted Apify MCP server.

Responsible use

Use this Actor only for data you are authorized to access. Follow the target website's terms, robots and access policies, and applicable privacy, database, copyright, anti-spam, and data-protection laws. Do not use it to bypass authentication or other access controls, collect private data, harass people, or make high-impact decisions without independent verification.

Support

When reporting a problem, include the Actor run ID, a redacted input, the expected result, and a small public example URL when applicable. Do not post API tokens, cookies, credentials, or personal data in an issue.