# IMF World Economic Outlook Scraper (`parseforge/imf-weo-scraper`) Actor

Scrapes IMF World Economic Outlook indicator values by code and optional ISO-3 country. Returns a flat time series with country, indicator, year, and value.

- **URL**: https://apify.com/parseforge/imf-weo-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** News, Other
- **Stats:** 2 total users, 1 monthly users, 89.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### IMF World Economic Outlook Scraper

**Scrape IMF World Economic Outlook indicators for any country, from GDP growth to inflation and debt.** Each row is a clean time series with country, indicator, year, and value. No API key or registration. Export to CSV, JSON, Excel, or XML.

The IMF World Economic Outlook database holds the most cited macroeconomic projections on the planet, but its DataMapper front end is built for browsing, not for pulling clean time series into your models. This Actor reads the public WEO data service directly, so you can pull any indicator code for one country or all countries in a single run. It returns a flat table that drops straight into Excel, R, Python, or your BI tool.

| Who uses it | What they scrape IMF World Economic Outlook for |
|---|---|
| Macro analysts | Pull the latest GDP growth and inflation projections for a set of countries into a spreadsheet |
| Quant researchers | Build a panel dataset of fiscal and external indicators across all WEO countries |
| Data journalists | Fact-check a story against the IMF's own numbers without manual downloads |
| Risk managers | Monitor sovereign debt and current account forecasts for exposure countries |

### What it does

This Actor collects IMF World Economic Outlook indicator values by indicator code and optional ISO-3 country, and returns each observation as a flat row with country, indicator, year, and value.

- 🌍 **All countries or one:** leave the country field blank to get every WEO member, or pass an ISO-3 code like USA, JPN, or DEU.
- 📈 **Any WEO indicator:** use the IMF DataMapper code, such as NGDP\_RPCH for real GDP growth, PCPIPCH for inflation, or GGXWDG\_NGDP for gross debt.
- 🧮 **Flat time series:** each row is one country, one indicator, one year, one value, ready for pivot tables and regressions.
- ⚙️ **Simple input:** three fields only, indicator code, optional country, and a cap on how many rows to return.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with IMF World Economic Outlook data

**📊 Build a macro panel dataset.**

A quant researcher pulls NGDP\_RPCH, PCPIPCH, and GGXWDG\_NGDP for all countries, then merges the flat rows into a panel for a cross-country growth regression.

**📰 Fact-check an economic story.**

A data journalist runs the Actor for a single country and indicator, then compares the IMF's latest projection with the number quoted in a press release.

**🛡️ Monitor sovereign risk.**

A risk manager pulls gross debt and current account forecasts for a watchlist of emerging markets each quarter and feeds the values into an early-warning model.

**📈 Track forecast revisions.**

An economist schedules the Actor to collect the same indicators after each WEO update, then diffs the new values against the previous run to see which countries were revised.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key** | Reads the public WEO data service directly, no registration or token management |
| **Clean schema** | Every row has the same columns, so you can append runs and build a history |
| **Any indicator** | Works with the full WEO code list, not a hand-picked subset |
| **Export anywhere** | CSV, JSON, Excel, or XML from the Apify dataset |

### How it compares

No other Store actor targets IMF World Economic Outlook the same way, so the honest comparison is with the alternatives teams actually weigh.

| | IMF World Economic Outlook Scraper | Build it in-house | By hand |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When IMF World Economic Outlook changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |

### Configure the run

Drive the Actor with an IMF DataMapper indicator code and an optional ISO-3 country code, and set a maximum number of rows to keep runs predictable. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "maxItems": 10
}
```

A larger pull:

```json
{
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.021 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [IMF World Economic Outlook Scraper](https://apify.com/parseforge/imf-weo-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to IMF World Economic Outlook through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/imf-weo-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check the indicator code. It must match the IMF DataMapper code exactly, including underscores, for example NGDP\_RPCH. Also verify the country code is a valid ISO-3 code like USA, not US.

**The run returns fewer rows than I expected.**

The maxItems field caps the output. Raise it if you need more rows. Also note that some indicators are not available for every country or every year.

**I get an error about the indicator code.**

Open the IMF DataMapper, select the indicator you want, and copy the code from the URL. Codes are case-sensitive and use underscores, not spaces.

**The data looks different from the IMF website.**

The WEO database is updated twice a year. Make sure you are comparing the same edition. The Actor always returns the latest published values.

**Can I get quarterly data?**

The WEO is an annual database. For quarterly or monthly macroeconomic data, use a different source such as the IMF IFS or a national statistics office.

### FAQ

| Question | Answer |
|---|---|
| Where do I find the indicator codes? | Use the IMF DataMapper at www.imf.org/datamapper. The code appears in the URL or the dataset download, for example NGDP\_RPCH for real GDP growth and PCPIPCH for inflation. |
| Can I get data for all countries at once? | Yes. Leave the country field blank and the Actor returns every WEO member country for the indicator you chose. |
| What time range does the data cover? | The WEO database includes historical estimates and projections several years into the future. The exact range depends on the indicator, but the Actor returns whatever the IMF publishes. |
| Does this include the latest WEO update? | Yes. The Actor reads the live WEO data service, so it reflects the most recent release, usually April and October each year with updates in between. |
| Can I filter by a group of countries, like the euro area? | The input accepts a single ISO-3 code. For multiple countries, run the Actor once per country or leave the field blank and filter the dataset afterward. |
| What is the maximum number of rows I can get? | You set the cap with the maxItems field, up to 1,000,000 rows per run. A single indicator for all countries and all years is typically far below that. |
| Is this an official IMF API? | No. The Actor reads the same public data service that powers the IMF DataMapper website. It does not require an API key or registration. |
| Can I use this for commercial research? | Yes, the WEO data is published for public use. Check the IMF's terms of use for attribution requirements if you republish the data. |
| What output formats are supported? | The Apify dataset can be exported to CSV, JSON, Excel, or XML from the run detail page or via the API. |
| How do I schedule regular updates? | Use Apify's scheduler to run the Actor on a cron, for example monthly or after each WEO release, and store the results in a dataset or key-value store. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by International Monetary Fund. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `maxItems` (type: `integer`):

How many indicators to collect per run.

## `indicator` (type: `string`):

IMF DataMapper indicator code, e.g. NGDP\_RPCH (Real GDP growth), PCPIPCH (Inflation), GGXWDG\_NGDP (Gross debt %GDP).

## `country` (type: `string`):

Filter to a single ISO-3 country code (e.g. USA, JPN, DEU). Leave blank for all countries.

## Actor input object example

```json
{
  "maxItems": 10,
  "indicator": "NGDP_RPCH"
}
```

# Actor output Schema

## `results` (type: `string`):

Scraped records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/imf-weo-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/imf-weo-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10
}' |
apify call parseforge/imf-weo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/imf-weo-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/3K3ooSeFdfiU66Jpm/builds/FbyO46a7DpRr43zZk/openapi.json