用途:世界银行数据 API 指南用于访问世界银行发展指标与国家统计。该 API 免费开放,无需认证,覆盖 217 个国家和地区、超过 16000 个发展指标,时间序列可跨数十年。
主要能力:可按国家、指标、年份检索数据;支持按主题检索指标、查询国家元数据;返回 JSON 或 XML;支持分页、日期范围和收入水平过滤,并提供指标与数据源元数据。
常用指标包括:NY.GDP.MKTP.CD(GDP,现价美元)、NY.GDP.PCAP.CD(人均 GDP)、SP.POP.TOTL(总人口)、SI.POV.DDAY(每日 2.15 美元贫困人口比例)、SE.ADT.LITR.ZS(成人识字率)、SH.XPD.CHEX.GD.ZS(经常性卫生支出占 GDP 百分比)、EN.ATM.CO2E.PC(人均二氧化碳排放)。
使用方式:核心端点形如 https://api.worldbank.org/v2/country/{country_code}/indicator/{indicator_code}?format=json,country_code 可用 ISO 二字或三字代码,或用 all;indicator_code 为世界银行指标代码;还可传 date、per_page(默认 50,最大 32500)、page。查找全部指标可请求 https://api.worldbank.org/v2/indicator?format=json&per_page=50;按主题检索可请求 https://api.worldbank.org/v2/topic/8/indicator?format=json&per_page=20;国家元数据可请求 https://api.worldbank.org/v2/country/CN?format=json。示例:curl "https://api.worldbank.org/v2/country/US/indicator/NY.GDP.MKTP.CD?format=json&date=2020:2024"。
适用场景:发展经济学、公共卫生、教育政策、环境科学与政治科学的跨国比较研究,如面板回归、贫困与不平等分析、环境与经济关系研究、政策评估等。
限制与注意事项:无严格速率限制,但建议每秒 1 至 2 次请求;默认返回 XML,需显式指定 format=json;许多指标存在空值,使用前应检查;可用 EUU、WLD、LIC 等聚合代码获取汇总数据;MRV=1 可取各国最新年份值;大规模分析可考虑 data.worldbank.org 的批量下载。本资料未提供收费、价格或官方支持信息。