浏览全部文档

按国家划分的贸易覆盖范围

哪些国家的数据来自本国海关或统计机构,哪些来自 UN Comtrade 或其他国家的报告,自何时起,以及哪些国家提供产品数据。

概览

Narwhal 提供 181 个国家的贸易数据,每个响应都带有标签,说明数据来自哪个来源:own 表示该国自己的海关或统计机构,third_party 表示其向 UN Comtrade 的申报,partner_reported 表示其他国家对该国的报告。本页说明哪些国家的数据来自哪个来源,以及每个来源能提供和不能提供什么。

要了解当前已存的月份,请调用覆盖范围路由:它给出目前为各国提供数据的来源,以及已存的首个月份和最新月份。

本国机构

这些国家的数据来自其本国机构。机构有发布的,历史数据自 2010 年 1 月起;表中另有说明的,起始时间较晚。数值以该机构自身的货币计。

国家发布机构币种历史数据起始时间伙伴国产品
英国英国税务海关总署(HM Revenue & Customs)GBP2010-01全部伙伴国HS6
27 个欧盟成员国,各自作为一个报告国Eurostat ComextEUR2010-01全部伙伴国HS6
美国美国人口普查局USD2010-01全部伙伴国HS6
加拿大加拿大统计局CAD2010-0127 个具名伙伴国、作为一个组的欧盟,以及一个“其余”行仅伙伴国总额
墨西哥国家统计、地理和信息研究所(INEGI,National Institute of Statistics and Geography)USD2015-01全部伙伴国仅伙伴国总额
澳大利亚澳大利亚统计局(ABS)AUD2010-01全部伙伴国仅伙伴国总额
智利智利国家海关局(Servicio Nacional de Aduanas de Chile)USD2020-01全部伙伴国HS6
日本日本财务省贸易统计JPY2010-01全部伙伴国HS6
巴西MDIC Comex Stat(巴西发展、工业、外贸和服务部)USD2010-01全部伙伴国HS6
挪威挪威统计局(SSB)NOK2010-01全部伙伴国HS6
瑞士瑞士联邦海关和边境安全局(BAZG,Federal Office for Customs and Border Security)CHF2010-01全部伙伴国HS6
新西兰Stats NZNZD2015-01全部伙伴国HS6
泰国泰国商务部THB2022-01全部伙伴国HS4

HS6 表示产品路由可返回 2 位、4 位和 6 位的数据。HS4 表示它可返回 2 位和 4 位的数据:Narwhal 存有的泰国产品数据为 4 位。4 位和 6 位的数据行由该机构的明细行构建;该机构仅在章级别列出的明细行(例如被保密的明细)出现在章的响应中,而不出现在 4 位和 6 位的响应中。它的数值仍包含在伙伴国总额之内。

限制

  • 加拿大、墨西哥和澳大利亚的本国机构只提供伙伴国总额。它们 4 位和 6 位的产品数据未存入,因此产品路由和 4 位或 6 位的 hs 返回 404 basis_not_available。在章级别(2 位),带 hs 的伙伴国路由和产品路由根据其他国家的报告为这些国家提供数据,标记为 partner_reported。以其中任一国为 reporter 并带 hs 的开放式查询返回 404。
  • 加拿大的机构列出其 27 个最大的伙伴国和作为一个组的欧盟。其余所有贸易合并为一行,partner_kind 为 unallocated,unallocated_reason 为 rest,因此各行加总仍等于总额。
  • 墨西哥的研究所把部分伙伴国单元格作为保密数据隐去。总额减去可见伙伴国后的余额是一行,unallocated_reason 为 confidential。
  • 各机构的贸易统计口径各不相同:离岸价(FOB)或到岸价(CIF)、总贸易体系或专门贸易体系、按原产地或目的地划分伙伴国。响应在 valuation_basis、trade_system 和 partner_basis 中如实给出机构的说法,机构没有说明时则为 not_stated。Narwhal 不会使两个国家的数据变得可比。
  • 智利自 2020 年 1 月起,这是每个月在两个流向上都能加总吻合的第一年。墨西哥和新西兰自 2015 年 1 月起,即发布方文件的起点。泰国自 2022 年 1 月起,即该部发布的 HS 2022 产品清单的第一个月。Narwhal 从商务部网站的国别报告读取泰国的出口数据,该报告与泰国海关一致,不含复出口;进口数据则取自该部的开放 API。该部公布的出口总额口径包含复出口,每月高出 0.03% 至 0.6%。
  • 最新月份取决于该机构的发布时间表,见 latest_period。机构尚未发布的月份返回 404 period_not_published。数据按当前存有的内容提供:机构会修订数据,且没有 as_of。 机构公布更新日期的,Narwhal 每隔几小时检查一次,并重新读取自上一年1月以来该机构此后修订过的任何月份。对于其他机构,Narwhal 每天或每周重新读取最近7个月。这些机构对更早月份的修订不会被采纳。
  • HS 版本之间从不相互转换。每一行都注明其来源月份所用的版本。

计划接入的机构

计划接入更多机构:韩国、印度、印度尼西亚、土耳其、南非、沙特阿拉伯、巴基斯坦、哈萨克斯坦、吉尔吉斯斯坦、摩尔多瓦、纳米比亚、乌拉圭、瓦努阿图、巴林、加纳和冰岛。在某个机构接入之前,该国的数据与下文其他所有国家一样提供。接入后,同一请求会返回 basis 为 own 的数据,请求中无需任何改动。

其他所有国家

覆盖范围清单中 181 个国家里的其他所有国家,其数据来自 UN Comtrade 或其他国家的报告。清单之外的国家返回 404 country_not_covered。不带 basis 的请求先取 own,再取 UN Comtrade,然后取伙伴国报告。按产品划分时,先取 own,再取伙伴国报告。

UN Comtrade(third_party,source 为 UN Comtrade)是该国向联合国提交的自己的月度申报数据。它只提供伙伴国总额,没有产品。各国按自己的时间表申报,因此最新月份可能落后很多:覆盖范围路由上的 comtrade_latest_period 会显示。

伙伴国报告(partner_reported)由其他国家对该国的报告构建,进出口流向互换:它们从该国的进口即为该国的出口,它们对该国的出口即为该国的进口。reporters_included 列出所用报告所属的国家,note 说明这些数据是什么。它只到章(2 位),最多涵盖 12 个月,没有官方总额,不接受 top、share、ytd 或 change。

伙伴国报告的响应与该国自己的数据是不同的计量,两者可能相差很大。两个国家很少以相同的价值记录同一笔贸易:一方按离岸价(FOB)计,另一方按到岸价(CIF)计,对于经第三国过境的货物,双方还可能给出不同的伙伴国。请使用标签,不要把伙伴国报告的数据当作该国的官方数据。

查询某个国家

GET /v1/trade/coverage 为每个国家返回一行。answers_with 是目前提供数据的来源,tiers_held 列出所有有数据行的来源,first_period 和 latest_period 是来自该国本国机构的已存月份,products_tier 说明谁按产品提供数据。该路由免费。

贸易覆盖范围路由 · 贸易数据 API 参考

此页面对你有帮助吗?