World Bank Open Data

World Bank Open Data 提供世界银行及合作来源的全球发展指标，可从国家、主题或指标页面观察经济、人口、教育、健康、贫困、能源与环境等时间序列。跨国比较最容易出错的地方不是找不到数字，而是把名称相近、来源不同或单位不同的序列接在一起；因此应先固定指标代码和来源，再决定用网页、DataBank 还是 API。

从指标代码建立可复现口径

每条指标都有稳定代码，例如总人口常用 SP.POP.TOTL，现价美元 GDP 常用 NY.GDP.MKTP.CD。代码的后缀往往包含单位或计算方式线索，但不能只靠拆码理解含义；还要读取指标名称、单位、source note、source organization 和主题信息。同一指标可能属于多个来源库，API 查询若不固定 source，可能得到与预期数据库不同的序列。

网页适合看趋势，DataBank 适合批量切片

指标页适合快速切换国家、年份和图表，先判断量级与走势；需要多个国家、指标和年份的矩阵时，再进入 DataBank。选取序列时应从 Series、Country/Economy 和 Time 三个维度分别确认，不把“最近五年”误解为每个经济体都有连续五个观测值。导出后保留原字段说明和下载日期，空值不要自动填成 0。

Indicators API 不需要 API Key

当前 V2 Indicators API 可以直接访问，不要求 API Key。一个基础请求由版本、国家或经济体、指标代码和查询参数构成，例如 https://api.worldbank.org/v2/country/br/indicator/NY.GDP.MKTP.CD?date=2006&format=json。V1 已停止支持，旧脚本若返回 Resource not found，应先检查路径是否包含 v2。

• date=2000:2025 用于限定时间范围，format=json 改为 JSON。
• page 与 per_page 用于处理大结果集，不能只保存第一页。
• footnote=y 可请求脚注；多个指标需属于同一来源并按文档组合。
• CSV、Excel 或 XML 下载会返回压缩包，自动化流程应同时校验状态、文件名和更新时间。

跨国比较要主动处理不可比

同一指标在不同国家可能缺少年份，或受统计能力、边界变化和修订影响。金额还要区分现价、常价、本币与美元；比例指标不能与绝对数量混排。项目验收时，应能用保存的指标代码、来源 ID、国家代码、日期范围和 API 参数重新取得同一口径，并在报告中注明脚注和下载日期。入口：https://data.worldbank.org/