data.stats.gov.cn EasyQuery API Example

NBS EasyQuery API (data.stats.gov.cn)

Python QueryData Example

This is the shape of a typical data.stats.gov.cn/easyquery.htm?m=QueryData request. In real use, add timeouts and retries because overseas access is not guaranteed.

import json
import requests

url = "https://data.stats.gov.cn/easyquery.htm"
params = {
    "m": "QueryData",
    "dbcode": "hgnd",
    "rowcode": "sj",
    "colcode": "zb",
    "wds": "[]",
    "dfwds": json.dumps([
        {"wdcode": "zb", "valuecode": "A020101"}
    ], ensure_ascii=False),
}

response = requests.get(url, params=params, timeout=20)
response.raise_for_status()
payload = response.json()

If the request fails from an overseas network, test again from a mainland China network or use a stable dataset endpoint for application traffic.

CPI City Monthly Query Pattern

Searches like "data.stats.gov.cn easyquery api cpi city monthly" usually need the monthly database and a CPI indicator code. The exact valuecode depends on the NBS table and city dimension selected in the official UI.

Use the official NBS interface to identify the indicator code first, then copy the dfwds pattern into a scripted request. For general CPI time series, the cleaned China CPI dataset is easier to reuse.

NBS API vs chinadata.live API

NBS Metadata and Code Catalog

EasyQuery is metadata-driven. A reliable NBS workflow needs more than the numeric value: store the indicator name, source unit, frequency, database code, dimension code, value code, source URL, retrieval date, and any unit conversion applied after download.

The table below maps common research intents to ChinaData.live API pages and the usual EasyQuery database family. Treat it as a catalog bridge, not a guarantee that every slug is the exact NBS valuecode.

For production use, keep the source-side code catalog and the cleaned API slug catalog separate. The source catalog answers "what did NBS publish?", while the API catalog answers "what stable endpoint should my app call?"

JSON API Response Example

The chinadata.live API returns clean English JSON — no nested NBS nodes or Chinese field names:

{
  "success": true,
  "data": {
    "id": "china-ppi",
    "slug": "china-ppi",
    "title": "Producer Price Index (YoY)",
    "unit": "% (YoY, same month last year=100)",
    "frequency": "monthly",
    "source": "National Bureau of Statistics",
    "source_url": "https://data.stats.gov.cn/",
    "data": [
      { "date": "2025-01", "value": -1.8 },
      { "date": "2025-02", "value": -2.0 },
      { "date": "2025-03", "value": -2.3 }
    ],
    "dateRange": { "start": "1996-01", "end": "2026-05" }
  }
}

Note: CPI and PPI values are pre-converted from NBS index format (e.g. 97.7 → −2.3%) so you can use them directly without subtracting 100.

Related Datasets