先给一条能直接复现的结果:查 2024 年中国对世界的货物出口,取回的值是 3,576,543,293,842 美元,约 3.58 万亿美元;把伙伴换成美国(842),是 525,648,764,497 美元,约 5,256 亿美元。两条都来自联合国 Comtrade 的公开预览接口,不需要密钥,一条 URL 就够。
UN Comtrade(联合国商品贸易统计数据库)是各国海关/统计部门向联合国统计司申报的官方贸易统计。2024 年度数据已可查,入口是 comtradeplus.un.org。这份导读把它的数据板块、查询参数、免费与付费的边界、以及四个必须先定的口径讲清楚——它是个工具入口,不是一份可以打包下载的现成数据库。
这个站点有哪几块数据
| 板块 | 内容 | 什么时候用 |
| Official Trade statistics | 按报告国、伙伴、商品组织的官方货物与服务贸易统计,是主库 | 绝大多数按国家/伙伴/商品的查询 |
| Tariffline data | 各国申报的税则行级明细(比 HS 六位更细) | 需要具体税号、税率相关明细时 |
| MBS(T35/T38) | 月度统计公报的总值与国际换算因子 | 做月度跟踪、汇率与单位换算 |
| Trade matrix | 一年内每个报告国与伙伴的完整矩阵视图 | 快速看双边全景,不必逐条查 |
| Standard unit values | 每类 HS 商品、每个流向的典型美元单价 | 价格合理性交叉检验 |
| World share | 各报告国在世界贸易总值中的份额 | 份额与排名 |
| Metadata 三件套 | 发布说明、参考表(国家/伙伴/商品代码)、数据可得性 | 开查之前必看,见下文 |
| Bulk files | 按报告国与期打包的压缩文件、Tariffline 全量 | 需要整批数据而非逐条调用 |
查 2024 年数据要给的参数
核心是五个码:报告国(reporterCode,联合国 M49 数字码,中国 156、美国 842)、伙伴(partnerCode,0 代表世界)、流向(flowCode,X 出口/M 进口)、商品(cmdCode,TOTAL 为全部商品,也可给 HS 编码或 AG2 这类聚合层级)、期(period,年度写 2024)。
公开预览端点的形状是 /public/v1/preview/C/A/HS,三个字母分别对应「货物/年度/HS 分类」。返回的是长表,一行一个「报告国×伙伴×商品×流向×期」的组合,关键字段包括 primaryValue(主值)、fobvalue 与 cifvalue(离岸/到岸值,视流向而定)、净重、运输方式码(motCode)、海关代码(customsCode)、分类版本(classificationCode,本例为 H6),以及一个 legacyEstimationFlag 标记该值是否经过估算或沿用旧口径。
两个已验证的取数样本
| 查询 | 2024 年值(美元) | 说明 |
| 中国(156)出口至世界(0),TOTAL | 3,576,543,293,842 | 约 3.58 万亿;fob 口径 |
| 中国(156)出口至美国(842),TOTAL | 525,648,764,497 | 约 5,256 亿;fob 口径 |
这两个值都是报告国申报的出口额,属于「直接申报值」。同一笔双边贸易,用美国申报的进口值去查会得到另一个数——差额来自 CIF/FOB 计价、转口与统计时点。这不是数据错误,是贸易统计的常态,但在做双边平衡分析时必须选定一侧并明说。
免费与付费的边界在哪
不注册也能用:公开预览端点可直接返回数据,但有两个限制——返回行数有限、请求频率受限(短时间内连续调用会返回 429,需要间隔重试)。所以它适合核对单点、验证口径,不适合拉全量。
要正式提取,在 Comtrade 注册一个免费订阅密钥,按额度调用 API;批量文件与更大额度走订阅/付费档。另外有两处容易混:货物(C)与服务(S)是两套数据,不能相加;Tariffline 与 Official Trade statistics 是两套粒度,同一年份的数也不该混着加总。
开查之前必须定的四个口径
第一,报告方还是镜像方。做出口分析用出口国申报,做进口分析用进口国申报;用对方数据反推会带进计价与转口误差。写方法时要把选了哪一侧写出来。
第二,HS 版本。classificationCode 会随年份变化(从早期版本到 H6),跨年拼接同一商品序列时要用官方的 HS 转换表,不能按编码字面直接对齐。
第三,聚合层级。TOTAL、AG2(章节级)、六位明细是三个层级,混用会重复计算。做行业汇总时,先确认自己用的是哪一层。
第四,可得性与修订。站点有「数据可得性」页,标明每个报告国覆盖哪些年份、什么时候发布;各国还会修订历史值。引用时最好写明「数据版本/查询日期」,否则同一 URL 明年查出来的数可能不同。
三类读者怎么用它
做贸易统计与实证研究的,先看数据可得性页确认目标国 2024 年是否齐、发布时间是什么,再决定口径;报告国与镜像国的差异要写进稳健性部分。
做行业进出口分析的,路径是 HS 章节到六位,再用「标准单位价值」视图做一次价格检验——单价异常往往说明编码归类或单位口径出了问题。
只是要快速核对一个数的,公开预览端点一条 URL 就够,不必注册。
────────────────
接口参数与返回字段说明、两个样本的原始记录、八个数据板块的对照表、免费与付费的边界、四个口径清单,以及引用格式,都放在下面,回复本帖可见。
把经管之家装进你常用的 AI 智能体中 一键快捷安装经管之家 MCP/技能,让 AI 帮你查教程、找数据、读论坛帖子。 检索、阅读公开帖子不收费,安装可申请领取:3 通用积分+100 论坛币+3 元论坛资金 请点击查看安装教程与福利 → 说明: AI 算力按所用平台规则计算;附件按原帖条件获取;福利领取条件以活动页面为准。 |