上海数据观察上海统计年鉴与城市研究平台
开通会员
开发者文档

把年鉴数据接入
你的研究工作流

通过稳定的 HTTP API 查询长期指标、年鉴版本与完整二维表格，并保留统计口径、数据版本和官方来源。

创建 API 密钥查看 API 参考
调用示例

从时间序列到完整表格

示例使用环境变量读取密钥，不会把密钥写入代码。复制后只需安装对应 HTTP 客户端即可运行。

指标

查询生产总值历史序列

适合直接进行年度趋势分析，响应中的 value 已经是数值类型。

export SHDATA_API_KEY="sdo_请替换为你的密钥"


curl --request GET \
  --url "https://shdata.watch/api/v1/data/metrics/gdp?fromYear=2015&toYear=2024" \
  --header "Authorization: Bearer $SHDATA_API_KEY"
年鉴表格

先检索，再读取完整二维表

先从目录结果取得稳定的 editionYear、pageId 和 tableNumber，再请求对应表格内容。

curl --request GET \
  --url "https://shdata.watch/api/v1/data/tables?editionYear=2025&q=生产总值&limit=10" \
  --header "Authorization: Bearer $SHDATA_API_KEY"


# 从目录结果取 editionYear、pageId、tableNumber，再读取完整表格：
curl --request GET \
  --url "https://shdata.watch/api/v1/data/tables/2025/C0301-51a44e58/1" \
  --header "Authorization: Bearer $SHDATA_API_KEY"