China Macro Revision Monitor

Monitor a small, fixed set of China macroeconomic indicators from the official World Bank World Development Indicators API. Each run returns structured annual observations and compares them with the prior delivered baseline to identify newly published periods and historical revisions.

This Actor is designed for research, business intelligence and scheduled data-quality checks. It is keyless, uses no proxy, accepts no arbitrary URL and is restricted to China (CHN) and WDI source 2.

What it monitors

• GDP level and annual growth;
• consumer-price inflation;
• foreign direct investment level and share of GDP;
• exports and imports;
• unemployment, population and energy use;
• baseline_created, no_change, new_observation, revision and mixed_change states.

The first valid run for an indicator and watchName creates a baseline. A replay of the same source facts returns no_change. A previously null or absent period becoming numeric is new_observation; a changed previously numeric period is a revision. The baseline is updated only after Dataset delivery is confirmed. Transport or source-contract failures produce explicit free error rows and preserve the prior baseline.

Quick start

{
  "indicators": [
    "NY.GDP.MKTP.KD.ZG",
    "BX.KLT.DINV.WD.GD.ZS"
  ],
  "startYear": 2021,
  "endYear": 2025,
  "watchName": "china-macro-main"
}

Run this once, inspect the Dataset and then create an Apify Schedule with the same watchName, indicators and year window. Annual WDI series usually do not justify an hourly schedule; weekly or monthly checks are proportionate.

Input

Field	Required	Description
indicators	no	1-5 unique codes from the closed WDI whitelist; default is GDP growth plus FDI inflows as a share of GDP.
startYear	no	Inclusive first year, 1960 or later.
endYear	no	Inclusive last year, no later than the current UTC year.
watchName	no	Stable 1-80 character private baseline scope.

The inclusive window is limited to 10 years. Country, source ID, host, path, pagination, license, proxy and credentials are not buyer-controlled. Invalid input fails before any network request.

Output

Each valid indicator response yields one Dataset row. Missing WDI values stay explicit:

{
  "watchName": "china-macro-main",
  "indicator": {
    "id": "NY.GDP.MKTP.KD.ZG",
    "name": "GDP growth (annual %)",
    "unit": "percent"
  },
  "country": {"code": "CHN", "name": "China"},
  "window": {"startYear": 2021, "endYear": 2025},
  "found": true,
  "changeType": "revision",
  "changedPeriods": ["2023"],
  "newObservations": [],
  "revisions": [{"period": "2023", "previousValue": 5.2, "currentValue": 5.4}],
  "observations": [
    {"period": "2023", "value": 5.4, "isMissing": false},
    {"period": "2025", "value": null, "isMissing": true}
  ],
  "sourceUpdatedAt": "2026-07-24",
  "source": {
    "provider": "World Bank",
    "dataset": "World Development Indicators",
    "sourceId": "2",
    "license": "CC BY 4.0",
    "attribution": "Source: World Bank, World Development Indicators (WDI), licensed under CC BY 4.0."
  },
  "partial": false,
  "error": "",
  "isDemo": false
}

A valid response containing only null observations is delivered as a free no_observation row. A timeout, HTTP failure, wrong country/source/indicator identity, malformed JSON or changed upstream schema is a free error row with partial: true. Neither case is silently converted into a numeric value.

Source, license and responsible reuse

The Actor calls only:

https://api.worldbank.org/v2/country/CHN/indicator/<approved-code>?source=2&...

The World Development Indicators dataset is published under CC BY 4.0, which permits commercial reuse with attribution. Every row carries its API URL, dataset link, license link and attribution. Delta and revision fields are marked as a modification of source observations; they are not official World Bank conclusions. Do not use the World Bank name or logo to imply endorsement.

Pricing

Pay per event on the FREE tier: $0.005 per run start + $0.003 per successfully delivered indicator check containing at least one finite observation. Explicit null-only and source-error rows are free.

Tier	Start	Indicator check	Discount
FREE	$0.00500	$0.00300	0%
BRONZE	$0.00475	$0.00285	5%
SILVER	$0.00450	$0.00270	10%
GOLD	$0.00425	$0.00255	15%
PLATINUM	$0.00410	$0.00246	18%
DIAMOND	$0.00400	$0.00240	20%

Dataset delivery and the indicator-checked charge use one SDK call. Pricing, the zero-priced default Dataset event and remaining charge budget are checked before source work. If those values cannot be verified, paid work fails closed.

API and automation

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('zinin/china-macro-revision-monitor').call({
  indicators: ['NY.GDP.MKTP.KD.ZG', 'BX.KLT.DINV.WD.GD.ZS'],
  startYear: 2021,
  endYear: 2025,
  watchName: 'china-macro-main',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('zinin/china-macro-revision-monitor').call(run_input={
    'indicators': ['NY.GDP.MKTP.KD.ZG', 'BX.KLT.DINV.WD.GD.ZS'],
    'startYear': 2021,
    'endYear': 2025,
    'watchName': 'china-macro-main',
})
print(client.dataset(run['defaultDatasetId']).list_items().items)

Use the included Task fixture with an Apify Schedule. A webhook on ACTOR.RUN.SUCCEEDED can pass the Dataset changes view to n8n, Make, Slack or a data warehouse. Treat ACTOR.RUN.FAILED and partial: true as unknown source state.

中文说明

此 Actor 通过世界银行官方 World Development Indicators API 监控中国宏观数据。 数据源固定为中国（CHN）和 WDI source 2，无需 API Key，也不使用代理。首次有效 运行建立基线；后续运行会区分 no_change（无变化）、new_observation（新增数据）和 revision（历史值修订）。缺失值会明确返回 null，网络或上游格式错误会返回免费的 错误记录，并保留原有基线，不会生成或猜测数值。

建议使用相同的 watchName 建立每周或每月定时任务。每行均包含世界银行来源链接、 WDI 数据集链接和 CC BY 4.0 署名信息。Actor 的变化计算属于二次处理，不代表世界银行 官方判断或背书。

Limitations

• WDI annual observations can be delayed, revised or remain null for recent years.
• The Actor monitors at most five approved indicators and ten inclusive years per run; it is not a bulk World Bank exporter.
• A missing value is not evidence that an economic event did not occur.
• Values are source observations, not investment, legal, accounting or policy advice.
• Baselines are scoped by watchName; changing the year window creates a new baseline comparison for that indicator.
• World Bank availability and schema can change. Failures remain explicit unknown state.

Built by zinin. Questions: Telegram @timzinin.