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.

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

Pay per event is designed around two transparent synthetic events:

• Actor start: $0.00005 per start event (memory-scaled by Apify)
• WEO observation: $0.0005 for each dataset item

For example, a 100-observation run costs about $0.05005 in event charges. The Actor stops at maxResults and reserves the synthetic start event when calculating how many observations fit inside ACTOR_MAX_TOTAL_CHARGE_USD; your Apify run-level maximum charge is also enforced by the platform. Live Apify pricing is canonical and is re-read from the Actor's monetization settings.

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.