按国家和日期搭建经济日历
按 UTC 列出你所选国家和日期的发布时间。
阅读指南 →所有 API
劳动力统计 API 总览
读取各国官方失业率和劳动力参与率数据。通过 REST 或 MCP 使用劳动力统计 API，获取最新已确认数值、指定期间数值或带日期的历史。
首次请求
获取最新值
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/unemployment?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"端点
GET失业率/v1/economics/{country}/unemployment
获取一个观测期的官方失业率。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period可选省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。
version_id可选可选的不可变发布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略则读取当前已收录的指标。
响应字段
country字符串所请求的大写 ISO 三字母国家代码。
period字符串返回的官方观测期间。
rate十进制字符串已发布的比率，单位为百分比，范围为 0 至 100，包含两端。
released_on日期官方发布日期，而不是 Narwhal 的检索时间。
source对象可选的 source 对象仅在统计数据经由分发方获得时出现，包含 publisher（分发方所注明的原始发布方）和 distributor（分发机构）。存在 source 时，released_on 是分发方的发布日期，而不是原始发布方的发布日期。由发布方直接提供的序列没有 source。
完整参考文档 →
GET失业率历史数据/v1/economics/{country}/unemployment/observations
获取一个国家当前已接受的失业率时间序列。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
start可选起始观测期（包含该期）。
end可选结束观测期（包含该期）。
limit可选返回的最大期间数。默认值为 100。页面可能包含更少的期间；请继续使用 next_cursor。
cursor可选上一页返回的next_cursor。
version可选只接受 first_reported：返回每个期间首次存储的值，并附带 first_reported_at。不能与 as_of 同时使用。
as_of可选返回截至指定 UTC 日终时已发布的序列。不能与 version 同时使用。
响应字段
country字符串请求的大写 ISO alpha-3 国家代码。每页返回一次，不在每条观测记录中重复。
start字符串仅当 Narwhal 将请求的 start 推迟到更晚的期间时出现。不会返回更早的期间。
as_ofRFC 3339 时间戳来源最后更新本页最新观测值的时间，精确到整秒，使用 UTC。
source对象通过分发机构获取的统计数据的来源信息；请参阅最新值操作。
observations数组按时间从早到晚排列的已采纳观测记录，每个期间一条。来源缺失的值会被省略，绝不填补。每页观测记录数可能小于 limit；请继续使用 next_cursor，直到其值为 null。
observations[].period字符串观测值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 时间戳仅在 version=first_reported 时出现。这个 UTC 时间戳记录 Narwhal 首次存储该期间的时间（如果各项指标是分开存储的，则取最晚的时间）。在开始采集之前发布的期间，显示的是 Narwhal 的首次采集时间。
observations[].rate十进制字符串已发布的比率，单位为百分比。
next_cursor字符串或 null将此值原样作为 cursor 传入，以读取下一页；最后一页为 null。
完整参考文档 →
GET劳动力参与率/v1/economics/{country}/labour-force-participation
获取一个观测期的官方劳动力参与率。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period可选省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。
version_id可选可选的不可变发布版本。使用 dataset.published 或 dataset.revised 事件中的 resource_version；省略则读取当前已收录的指标。
响应字段
country字符串所请求的大写 ISO 三字母国家代码。
period字符串返回的官方观测期间。
rate十进制字符串已发布的比率，单位为百分比，范围为 0 至 100，包含两端。
released_on日期官方发布日期，而不是 Narwhal 的检索时间。
source对象可选的 source 对象仅在统计数据经由分发方获得时出现，包含 publisher（分发方所注明的原始发布方）和 distributor（分发机构）。存在 source 时，released_on 是分发方的发布日期，而不是原始发布方的发布日期。由发布方直接提供的序列没有 source。
完整参考文档 →
GET劳动力参与率历史数据/v1/economics/{country}/labour-force-participation/observations
获取一个国家当前已接受的劳动力参与率时间序列。
参数
country必填一个受支持的大写国家代码；请参阅此操作的覆盖列表。
start可选起始观测期（包含该期）。
end可选结束观测期（包含该期）。
limit可选返回的最大期间数。默认值为 100。页面可能包含更少的期间；请继续使用 next_cursor。
cursor可选上一页返回的next_cursor。
version可选只接受 first_reported：返回每个期间首次存储的值，并附带 first_reported_at。不能与 as_of 同时使用。
as_of可选返回截至指定 UTC 日终时已发布的序列。不能与 version 同时使用。
响应字段
country字符串请求的大写 ISO alpha-3 国家代码。每页返回一次，不在每条观测记录中重复。
start字符串仅当 Narwhal 将请求的 start 推迟到更晚的期间时出现。不会返回更早的期间。
as_ofRFC 3339 时间戳来源最后更新本页最新观测值的时间，精确到整秒，使用 UTC。
source对象通过分发机构获取的统计数据的来源信息；请参阅最新值操作。
observations数组按时间从早到晚排列的已采纳观测记录，每个期间一条。来源缺失的值会被省略，绝不填补。每页观测记录数可能小于 limit；请继续使用 next_cursor，直到其值为 null。
observations[].period字符串观测值所代表的官方月份或季度。
observations[].first_reported_atRFC 3339 时间戳仅在 version=first_reported 时出现。这个 UTC 时间戳记录 Narwhal 首次存储该期间的时间（如果各项指标是分开存储的，则取最晚的时间）。在开始采集之前发布的期间，显示的是 Narwhal 的首次采集时间。
observations[].rate十进制字符串已发布的比率，单位为百分比。
next_cursor字符串或 null将此值原样作为 cursor 传入，以读取下一页；最后一页为 null。
完整参考文档 →
使用场景
覆盖范围
指标
国家
来源
- 澳大利亚澳大利亚统计局（ABS）
- 奥地利奥地利统计局、欧盟统计局（Eurostat）
- 比利时比利时统计局（Statbel）、比利时国家银行、欧盟统计局（Eurostat）
- 加拿大加拿大统计局
- 瑞士瑞士联邦统计局(FSO)、Eurostat
- 智利智利中央银行（BCCh）、智利国家统计局（INE）
- 哥伦比亚国家统计行政部（DANE）
- 捷克捷克统计局（ČSÚ）
- 德国德国联邦统计局（Destatis）
- 丹麦丹麦统计局、欧盟统计局（Eurostat）
- 西班牙西班牙国家统计局（INE）、西班牙税务局（AEAT）
- 爱沙尼亚爱沙尼亚统计局
显示全部 35 个来源
- 芬兰芬兰统计局、芬兰海关（Tulli）
- 法国法国国家统计与经济研究院（INSEE）、法国海关
- 英国英国国家统计局（ONS）
- 克罗地亚克罗地亚统计局（CBS）
- 爱尔兰中央统计局（CSO）
- 意大利意大利国家统计局（Istat）、欧盟统计局（Eurostat）
- 日本日本统计局、日本内阁府、日本 Customs
- 立陶宛立陶宛国家数据局
- 卢森堡STATEC、欧盟统计局（Eurostat）
- 拉脱维亚拉脱维亚中央统计局（CSB）
- 墨西哥国家统计、地理和信息研究所（INEGI）
- 马来西亚马来西亚统计局（DOSM）
- 荷兰荷兰统计局（CBS）
- 挪威挪威统计局（SSB）
- 新西兰Stats NZ
- 菲律宾菲律宾统计局（PSA）
- 波兰波兰统计局、欧盟统计局（Eurostat）
- 葡萄牙葡萄牙统计局（INE）
- 沙特阿拉伯统计总局（GASTAT）
- 新加坡新加坡统计局（SingStat）、新加坡政府发布的开放数据
- 斯洛文尼亚斯洛文尼亚共和国统计局（SURS）
- 瑞典瑞典统计局（SCB）
- 美国劳工统计局（BLS）、经济分析局（BEA）、美国人口普查局
相关 API
常见问题
目前上线了哪些劳动力指标？
失业率和劳动力参与率目前已上线。
可以获取历史劳动力数据吗？
是。除最新已确认数值外，也可以获取带日期的历史和确切期间的请求。
REST 和 MCP 使用同一个 API 密钥吗？
是。同一个 API 密钥适用于 REST 和 MCP。
从免费密钥开始
12 个月内每月赠送 10 美元免费额度，无需绑卡。每月 10 美元免费额度，无需绑卡。