World Bank 世界银行开放数据源

通过 curl tool 调用 World Bank Indicators API v2，获取 200+ 国家和地区的 16,000+ 经济与发展指标数据（GDP、人口、GNI、预期寿命、CO2 排放等）。

鉴权

World Bank API 免费且无需鉴权，直接发请求即可，不要传任何 token 或 API key。

通用约定

• Base URL：https://api.worldbank.org/v2
• 所有接口都是 GET，参数通过 query string 传递。
• 必须带 format=json，否则默认返回 XML。
• 分页参数：page（页码，从 1 开始）、per_page（每页条数，默认 50，最大 32500）。
• 日期范围：date=2020:2023（起止年份用冒号分隔）或 date=2022（单年）。
• 国家代码使用 ISO 3166-1 alpha-2（如 CN、US、JP）或 ISO alpha-3（如 CHN、USA）。多个国家用分号分隔：CN;US;JP。
• 数据范围：全球，覆盖世界银行成员国及主要经济体。
• 响应结构：返回数组 [pagination, data[]]，其中 pagination 包含 page、pages、per_page、total。

常用接口

一、查询国家/地区指标数据

这是最核心的接口，用于获取某个国家某个指标的时间序列数据。

GET https://api.worldbank.org/v2/country/{country_code}/indicator/{indicator_code}?format=json&date=2018:2023&per_page=100

示例 — 查询中国近 5 年 GDP（当前美元）：

GET https://api.worldbank.org/v2/country/CN/indicator/NY.GDP.MKTP.CD?format=json&date=2018:2023&per_page=100

关键返回字段：data[].country.value、data[].date（年份）、data[].value（指标值，可能为 null 表示暂无数据）、data[].indicator.value（指标名称）。

二、多国对比

用分号分隔多个国家代码：

GET https://api.worldbank.org/v2/country/CN;US;JP;DE/indicator/SP.POP.TOTL?format=json&date=2020:2023&per_page=200

三、查询所有国家（某一指标）

用 all 代替国家代码：

GET https://api.worldbank.org/v2/country/all/indicator/NY.GDP.PCAP.CD?format=json&date=2022&per_page=300

四、搜索可用指标

当不确定指标代码时，可按关键词搜索：

GET https://api.worldbank.org/v2/indicator?format=json&per_page=100

指标超过 16,000 个，建议告知用户具体需求后直接使用下方常用指标代码，而非遍历全部。

五、查询国家列表

GET https://api.worldbank.org/v2/country?format=json&per_page=300

关键返回字段：data[].id（ISO alpha-2）、data[].iso2Code、data[].name、data[].region.value、data[].incomeLevel.value。

常用指标代码速查

注意事项

• 部分指标数据有 1-2 年滞后（如最新数据可能只到 2022 年），value 为 null 时告知用户"该年份暂无数据"。
• 指标代码区分大小写，务必按上表准确使用。
• 如需按收入水平或地区聚合查询，可使用聚合代码代替国家代码，如 EAS（东亚太平洋）、HIC（高收入国家）。