中国大宗农产品进口信息发布 API

输入类别与报告期，一次返回该期食糖、乳制品、油脂油料、粕类、肉类的进口装船量与到港量，含本期、本月与下月预报。

持续整理商务部外贸司每半月发布的《大宗农产品进口信息发布》报告（PDF / HTML），将进口信息简述、进口装船与到港报告解析、清洗、标准化为结构化时序数据，统一通过 REST API 交付。

无需自己逐期下载、识别和录入 PDF 报告。

查看 API 文档

企业方案咨询JSON API半月更新同步

概览装船量到港量分海关来源

报告检索键 3

1 肉类报告类别

数据来源: 大宗农产品进口信息发布
发布频率: 每半月一期

2 2016-12-16~31 报告期（数据截至）

数据来源: 外贸司月度发布
下期报告期: 2017-01-01~15

3 牛肉及其副产品 细分品类

数据来源: 肉类报告
归类: 已结构化

已解析主报告实体

肉类
牛肉及其副产品

报告类别: 肉类
细分品类: 牛肉及其副产品
报告期: 2016-12-16~31
本期实际装船: 6,257.19 吨
本期实际到港: 17,506.94 吨
数据来源: 商务部外贸司

5 大类食糖·乳制品·油脂油料·粕类·肉类

每半月一期（数据截至每月 15 日 / 月底）

2016 起持续发布的月度报告归档

装船 / 到港本期·本月·下月预报

报告都可以免费下载，但距离“直接用于业务系统”还有很远。

真正的问题不是有没有报告，而是如何把分散在每半月发布的 PDF / HTML 报告中的进口装船、到港与预报数据，变成业务系统可以一次调用、持续跟踪的结构化时序。

原始数据分散在多期报告中 商务部外贸司 · 月度发布

001食糖进口报告每半月一期

002乳制品进口报告每半月一期

003油脂油料类进口报告每半月一期

004粕类 / 肉类进口报告每半月一期

报告结构化聚合 一次调用 · 装船到港 解析并统一字段后交付

01
数据分散
食糖、乳制品、油脂油料、粕类、肉类分属不同报告，且每半月一期，业务系统需要自行逐期下载与拼装。
02
格式为 PDF / HTML
官方报告以 PDF / HTML 发布，装船量、到港量与预报嵌在正文，无法直接对接系统，需自行识别录入。
03
口径不统一
每期报告含“本期 / 本月 / 下月预报”等多口径，细分品类（如牛肉、羊肉、猪肉）与单位（吨）需统一建模。
04
维护成本持续累积
半月一期的频率意味着持续的下载、解析与录入工程投入，且容易因漏更影响分析连续性。

从分散的月度报告，到可以直接调用的结构化时序

一期报告穿过六个可审计阶段，最终成为稳定、结构化、可关联的 JSON。

采集

持续同步商务部外贸司每半月发布的报告

source.capture()

解析

从 PDF / HTML 提取装船、到港与预报文本

parse · extract

标准化

统一本期 / 本月 / 下月口径与单位（吨）

schema.map()

关联

建立类别、细分品类与报告期关系

graph.link()

聚合

一次调用返回装船、到港与分海关数据

aggregate.v1

交付

通过稳定的 REST API 提供给业务系统

json_api.v1

你不需要维护报告下载、PDF 解析与口径对齐。调用 API，直接使用结果。

一套 API，覆盖大宗农产品进口报告的核心场景

统一 REST API · JSON 返回 · Bearer Token 鉴权。进口装船 / 到港查询位于产品核心，其余能力沿同一数据模型展开。

进口报告查询 API

粮油贸易、期货研究与供应链分析

输入类别与报告期，返回该期报告的结构化进口装船量、到港量与下月预报，含细分品类与时间序列。

报告类别
报告期
进口装船量
进口到港量
下月预报

进口监测 · 行情研究 · 供应链计划 · 贸易 SaaS 嵌入

GET /v1/agri-import/report?category=肉类&period=2016-12-16~31

静态演示 · 示例响应200 OK

{
  "query": {"category": "肉类", "period": "2016-12-16~31"},
  "items": [
    {
      "sub_category": "牛肉及其副产品",
      "shipment": {
        "current": 6257.19,
        "month": 28634.83,
        "next_forecast": 2020.08
      },
      "arrival": {
        "current": 17506.94,
        "month": 40636.83,
        "next_forecast": 34821.48
      },
      "unit": "吨"
    }
  ],
  "source": "MOFCOM 外贸司"
}

API 02

按细分品类时间序列 API

按细分品类（如牛肉、羊肉、猪肉及其副产品）返回跨多期的装船与到港时间序列，便于趋势分析。

GET /v1/agri-import/by-subcategory?subCategory=牛肉及其副产品 JSON

跨期趋势多报告期连续序列

口径一致本期 / 本月 / 预报统一

单位归一全部以吨计

API 03

分海关到港情况 API

返回某一报告期各海关进口到港情况，支持按类别与报告期检索。

GET /v1/agri-import/by-port?category=肉类&period=2016-12-16~31 海关 · 到港量 · 报告期

API 04

批量订阅与推送 API

订阅多个类别，新一期报告发布后自动推送结构化增量数据，适合持续监测。

POST /v1/agri-import/subscribe 增量推送 · Webhook · CSV 导出

这些数据，可以进入你的真实业务流程

不是额外打开一个后台，而是让农产品进口装船与到港数据出现在行情研究、供应链计划正在发生的位置。

粮油 / 农产品贸易商

在采购与库存环节查询最新一期进口装船、到港与预报，辅助到货节奏判断。

类别 + 报告期进口报告 API到货节奏

期货 / 研究机构

将细分品类（牛肉、猪肉、食糖等）跨期装船到港序列接入研究模型，做供需与行情分析。

细分品类时间序列 API研究序列

供应链 / 物流

结合到港量与分海关到港情况安排港口作业与库存周转。

到港口径分海关 API作业计划

贸易 / 资讯 SaaS

将进口监测能力嵌入商品与研究模块，向用户展示最新进口装船、到港与预报。

类别维度最新报告 API监测面板

数据与研究机构

使用结构化进口报告数据研究大宗农产品供需、到港节奏与年度趋势。

类别维度时间序列 API结构化数据集

数据来自商务部外贸司每半月发布的公开报告，已逐项解析

以下基于商务部外贸司《大宗农产品进口信息发布》肉类报告（报告期 2016-12-16~31，发布日期 2016-12-31）真实字段整理，并非实时调用；字段结构与官方报告一致。

细分品类本期装船(吨)本期到港(吨)下月预报到港(吨)

牛肉及其副产品6,257.1917,506.9434,821.48

羊肉及其副产品4,095.216,846.2112,693.90

猪肉及其副产品69,261.6265,428.80254,205.38

以上为肉类报告真实样例（报告期 2016-12-16~31）。五大类别（食糖、乳制品、油脂油料类、粕类、肉类）每半月一期，最新一期食糖报告数据截至 2026-06-15、发布于 2026-07-28；逐期明细随 agri_import_sample.json 一并归档。

进口报告 API 还可以进一步分析

细分品类跨期趋势
装船 / 到港节奏
下月预报偏差
分海关到港分布
类别季节性
进口监测面板

API 的价值，不只是“把报告返回给你”

GooFuture 的核心能力位于数据进入 API 之前：把分散在多期 PDF / HTML 报告中的进口装船、到港与预报数据，转成适合程序处理、关联和持续维护的时序数据模型。

解析

报告结构化

从每半月发布的 PDF / HTML 报告提取装船、到港与预报文本。

非结构化报告 → 结构化字段

归一

口径归一

统一本期 / 本月 / 下月预报口径与单位（吨），便于系统匹配。

多口径 → 统一口径

结构

类别标准化

统一食糖、乳制品、油脂油料、粕类、肉类五大类别与细分品类命名。

报告文本 → 标准字段

标记

报告期标记

标注报告期、发布日期与下期报告期，提供可追溯依据。

报告文本 → 可追溯字段

更新

半月同步

新一期报告发布后持续同步，降低企业自己的维护成本。

来源 → 同步

从咨询开通，到第一次调用，只需要三步

代码与响应均为静态示例。顾问会结合数据范围、调用量和交付方式提供接入方案。

01
联系顾问
扫码添加企业微信，说明业务场景、所需类别与预计调用量。
02
确认方案
确认接口范围、订阅类别、交付方式与企业支持需求。
03
开始接入
获取 API Key 与接入资料，将 JSON 结果接入研究、供应链或 SaaS 产品。

cURL响应

curl "https://api.goofuture.com/v1/agri-import/report?category=肉类&period=2016-12-16~31" \
  -H "Authorization: Bearer YOUR_API_KEY"

静态演示 · JSON 响应200 OK

{
  "data": {
    "category": "肉类",
    "period": "2016-12-16~31",
    "sub_category": "牛肉及其副产品",
    "shipment_current": 6257.19,
    "arrival_current": 17506.94,
    "unit": "吨"
  }
}

从测试，到生产环境

按调用量、订阅类别、推送方式与企业支持选择套餐。具体价格由顾问结合业务需求提供。

基础版

适合 API 测试和产品验证

咨询顾问获取

月请求量: 100
核心接口: 报告查询 / 时间序列
订阅类别: 1 类
推送: —

标准版

适合贸易商与中小团队

咨询顾问获取

月请求量: 5,000
核心接口: 全部核心查询
订阅类别: 3 类
推送: 邮件

推荐方案

专业版

适合研究机构与 SaaS

咨询顾问获取

月请求量: 50,000
并发能力: 更高并发
订阅类别: 5 类
数据交付: Webhook / CSV

企业版

适合平台、数据公司及大型企业

咨询顾问获取

月请求量: 大规模调用
数据交付: 增量数据推送
定制能力: 字段 / 数据集
技术支持: 企业技术支持

接入大宗农产品进口数据 API 前，最值得先确认的问题

关于公开报告、报告期口径、更新频率和商业集成的直接回答。

报告数据都是公开的，为什么还需要这个 API？

如果只需要偶尔看一期报告，直接使用商务部外贸司官方渠道即可。GooFuture 面向需要持续监测、跨期分析、系统集成与统一口径的团队，把分散在多期 PDF / HTML 报告中的进口装船、到港与预报数据，解析成一次调用可得的结构化时序。

数据从哪里来？

数据来自中华人民共和国商务部外贸司公开发布的《大宗农产品进口信息发布》，覆盖食糖、乳制品、油脂油料类、粕类、肉类五大类别，每半月一期，格式为 PDF / HTML。GooFuture 对原始报告进行采集、解析、清洗、标准化、关联与聚合，并通过 API 交付。

数据多久更新一次？

报告为每半月一期（数据截至每月 15 日与月底），由商务部外贸司发布。系统会在新一期报告发布后持续同步，最新一期食糖报告数据截至 2026-06-15、发布于 2026-07-28。

可以查到哪些字段？

进口报告查询 API 返回报告类别、报告期、细分品类、进口装船量（本期 / 本月 / 下月预报）、进口到港量（本期 / 本月 / 下月预报）、单位（吨）以及分海关到港情况。

“本期 / 本月 / 下月预报”口径是什么意思？

报告以进口商报告数据为基数：本期指报告期内的实际装船 / 到港；本月指自然月累计；下月预报指进口商预报的下月装船 / 到港量。API 会按统一口径返回，便于趋势与到货节奏分析。

你们与官方报告发布渠道有什么区别？

官方报告以 PDF / HTML 形式发布，单次只能看一期且无法直接对接系统。GooFuture 将报告解析、口径归一与类别标准化后聚合为一次调用，并提供时间序列、分海关与订阅推送能力，原始数据均来自公开报告。

可以把数据集成到自己的研究 / SaaS 产品吗？

可以。API 可以用于企业内部系统，也可以集成到行情研究、供应链与贸易 SaaS 产品中；商业使用范围以相应套餐和服务协议为准。

覆盖哪些农产品类别？

覆盖商务部外贸司《大宗农产品进口信息发布》五大类别：食糖、乳制品、油脂油料类、粕类、肉类；每类进一步细分（如肉类含牛肉、羊肉、猪肉及其副产品）。

不再自己逐期下载、识别和录入 PDF 报告。

从公开报告采集，到装船 / 到港解析、口径归一与报告期关联，我们已经处理好了。你的系统只需要调用 API。

企业顾问对接 · REST API · JSON 返回

中国大宗农产品进口信息发布 API

报告检索键 3

已解析主报告实体

数据分散

格式为 PDF / HTML

口径不统一

维护成本持续累积

采集

解析

标准化

关联

聚合

交付

进口报告查询 API

按细分品类时间序列 API

分海关到港情况 API

最新一期报告 API

批量订阅与推送 API

粮油 / 农产品贸易商

期货 / 研究机构

供应链 / 物流

贸易 / 资讯 SaaS

数据与研究机构

进口报告 API 还可以进一步分析

报告结构化

口径归一

类别标准化

报告期标记

半月同步

联系顾问

确认方案

开始接入

不再自己逐期下载、识别和录入 PDF 报告。