China Bulk Agricultural Products Import Report API

Enter a category and reporting period to get import shipment and arrival volumes for sugar, dairy, oils and oilseeds, meals and meat — including current period, month-to-date and next-month forecast.

We continuously compile the fortnightly Bulk Agricultural Products Import Reports (PDF / HTML) from the MoC Department of Foreign Trade, parsing, cleaning and standardising the import summaries and shipment/arrival reports into structured time series data, delivered uniformly through a REST API.

No need to download, read and key in PDF reports issue by issue yourself.

View API Docs

Enterprise solution enquiryJSON APIFortnightly sync

OverviewShipment volumeArrival volumeBy customs officeSource

Report search key 3

1 Meat Report category

Data sources: Bulk agricultural products import reports
Publish frequency: One issue per fortnight

2 2016-12-16~31 Reporting period (data as of)

Data sources: Department of Foreign Trade periodic release
Next reporting period: 2017-01-01~15

3 Beef and by-products Sub-category

Data sources: Meat report
Classification: Structured

Master report entity parsed

Meat
Beef and by-products

Report category: Meat
Sub-category: Beef and by-products
Reporting period: 2016-12-16~31
Current period actual shipments: 6,257.19 t
Current period actual arrivals: 17,506.94 t
Data sources: MoC Department of Foreign Trade

5Sugar · dairy · oils & oilseeds · meals · meat

FortnightlyOne issue (data as of the 15th / month end)

Since 2016Archive of continuously published reports

Shipment / arrivalCurrent period · month · next-month forecast

The reports are free to download, but they are far from being "ready for a business system".

The real problem isn't whether the report exists, but how to turn import shipment, arrival and forecast data scattered across fortnightly PDF / HTML reports into structured time series your business systems can fetch in one call and track over time.

Raw data scattered across multiple reports MoC Department of Foreign Trade · periodic release

001Sugar import reportOne issue per fortnight

002Dairy import reportOne issue per fortnight

003Oils and oilseeds import reportOne issue per fortnight

004Meals / meat import reportOne issue per fortnight

Report aggregation One call · shipment and arrival Parsed, unified and delivered

01
Data is scattered
Sugar, dairy, oils and oilseeds, meals and meat are in different reports, each published fortnightly, so your systems have to download and assemble them issue by issue.
02
Format: PDF / HTML
The official reports are published as PDF / HTML with shipment, arrival and forecast figures embedded in the text, so there is no direct system integration — you have to read and key them in yourself.
03
Inconsistent definitions
Each report carries several definitions such as current period / month-to-date / next-month forecast, and sub-categories (beef, mutton, pork) plus the unit (tonnes) all need unified modelling.
04
Maintenance costs keep piling up
A fortnightly cadence means ongoing download, parsing and data-entry effort, and missed issues easily break the continuity of your analysis.

From scattered periodic reports to a directly callable structured time series

A report issue passes through six auditable stages to become stable, structured, linkable JSON.

Collect

Continuous sync with the MoC Department of Foreign Trade fortnightly reports

source.capture()

Parse

Extract shipment, arrival and forecast text from PDF / HTML

parse · extract

Normalize

Unifies current period / month / next-month definitions and the unit (tonnes)

schema.map()

Relate

Links categories, sub-categories and reporting periods

graph.link()

Aggregate

One call returns shipment, arrival and by-customs data

aggregate.v1

Deliver

Delivered to your business systems via a stable REST API

json_api.v1

You don't have to maintain report downloads, PDF parsing or definition alignment.Call the API and use the results directly.

One API covering the core bulk agricultural import report scenarios

Unified REST API · JSON responses · Bearer token authentication. Import shipment / arrival lookup is the core of the product, with the other capabilities built on the same data model.

Import report lookup API

Grain and oil trading, futures research and supply chain analysis

Enter a category and reporting period to get structured import shipment volumes, arrival volumes and next-month forecasts, with sub-categories and time series.

Report category
Reporting period
Import shipment volume
Import arrival volume
Next-month forecast

Import monitoring · market research · supply chain planning · trade SaaS embedding

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

Static demo · Sample response200 OK

{
  "query": {"category": "Meat", "period": "2016-12-16~31"},
  "items": [
    {
      "sub_category": "Beef and by-products",
      "shipment": {
        "current": 6257.19,
        "month": 28634.83,
        "next_forecast": 2020.08
      },
      "arrival": {
        "current": 17506.94,
        "month": 40636.83,
        "next_forecast": 34821.48
      },
      "unit": "t"
    }
  ],
  "source": "MOFCOM Department of Foreign Trade"
}

API 02

Time series by sub-category API

Returns multi-period shipment and arrival time series by sub-category (such as beef, mutton, pork and their by-products) for trend analysis.

GET /v1/agri-import/by-subcategory?subCategory=beef-and-by-products JSON

Trends across periodsContinuous series across reporting periods

Consistent definitionsUnified current period / month / forecast

Unit normalisationAll in tonnes

API 03

Arrival by customs office API

Returns import arrivals by customs office for a reporting period, searchable by category and period.

GET /v1/agri-import/by-port?category=meat&period=2016-12-16~31 Customs · arrival volume · reporting period

API 04

Latest report API

Returns structured data from the most recent published report for a category, for system-side caching and automatic refresh.

GET /v1/agri-import/latest?category=sugar Latest reporting period · publish date · structured data

API 05

Batch subscription and push API

Subscribe to multiple categories and receive structured incremental data automatically after each new report — ideal for continuous monitoring.

POST /v1/agri-import/subscribe Incremental push · Webhook · CSV export

This data can flow into your real business processes

Not another back office to open, but agricultural import shipment and arrival data where market research and supply chain planning actually happen.

Grain, oil / agricultural traders

Check the latest shipment, arrival and forecast data during procurement and inventory planning to support arrival timing decisions.

Category + reporting periodImport report APIArrival pace

Futures / research institutions

Feed multi-period shipment and arrival series for sub-categories (beef, pork, sugar, etc.) into your research models for supply/demand and market analysis.

Sub-categoryTime series APIResearch series

Supply chain / logistics

Use arrival volumes and the by-customs breakdown to plan port operations and inventory turnover.

Arrival basisBy customs office APIOperations plan

Trade / information SaaS

Embed import monitoring into your product and research modules to show users the latest import shipments, arrivals and forecasts.

Category dimensionLatest report APIMonitoring dashboard

Data and research firms

Use structured import report data to research bulk agricultural supply and demand, arrival timing and annual trends.

Category dimensionTime series APIStructured datasets

Data comes from the MoC Department of Foreign Trade fortnightly public reports, parsed item by item

The following is based on the MoC Department of Foreign Trade Bulk Agricultural Products Import ReportsMeatCompiled from real report fields (reporting period 2016-12-16~31, published 2016-12-31); this is not a live feed and the field structure matches the official report.

Sub-categoryCurrent period shipments (t)Current period arrivals (t)Next-month forecast arrivals (t)

Beef and by-products6,257.1917,506.9434,821.48

Mutton and by-products4,095.216,846.2112,693.90

Pork and by-products69,261.6265,428.80254,205.38

The above is a real meat report sample (reporting period 2016-12-16~31). The five categories (sugar, dairy, oils and oilseeds, meals and meat) are published fortnightly; the latest sugar report covers data as of 2026-06-15 and was published on 2026-07-28. The issue-by-issue detail is archived in agri_import_sample.json.

The import report API supports further analysis

Sub-category trends across periods
Shipment / arrival pace
Next-month forecast variance
Arrival distribution by customs office
Category seasonality
Import monitoring dashboard

The value of an API is more than "returning the report to you"

GooFuture's core value lies before the data reaches the API: turning import shipment, arrival and forecast data scattered across multiple PDF / HTML reports into a time series data model that is program-friendly, linkable and maintainable.

Parse

Structured report

Extracts shipment, arrival and forecast text from the fortnightly PDF / HTML reports.

Unstructured reports → structured fields

Resolve

Definition normalisation

Unifies the current period / month-to-date / next-month forecast definitions and the unit (tonnes) so systems can match them.

Multiple definitions → unified definition

Structure

Category standardisation

Unifies naming for the five categories — sugar, dairy, oils and oilseeds, meals and meat — and their sub-categories.

Report text → standard fields

Flag

Reporting period marker

Records the reporting period, publish date and next reporting period as a traceable basis.

Report text → traceable fields

Update

Fortnightly sync

Continuous sync after each new report, cutting your maintenance costs.

Source → sync

From enquiry to your first API call in just three steps

Code and responses are static samples. Your consultant will propose an integration plan based on data scope, call volume and delivery method.

01
Contact a consultant
Scan the QR code to add us on WeCom and tell us your business scenario, the categories you need and your expected call volume.
02
Confirm the plan
Confirm endpoint scope, subscribed categories, delivery method and enterprise support needs.
03
Start integration
Get your API key and integration materials, then wire the JSON results into your research, supply chain or SaaS product.

cURLResponse

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

Static demo · JSON response200 OK

{
  "data": {
    "category": "Meat",
    "period": "2016-12-16~31",
    "sub_category": "Beef and by-products",
    "shipment_current": 6257.19,
    "arrival_current": 17506.94,
    "unit": "t"
  }
}

From testing to production

Choose a plan by call volume, subscribed categories, push method and enterprise support. Your consultant quotes based on your business needs.

Basic

For API testing and product validation

Contact a consultant

Monthly requests: 100
Core endpoints: Report lookup / time series
Subscribed categories: 1
Push: —

Standard

For traders and small teams

Contact a consultant

Monthly requests: 5,000
Core endpoints: All core queries
Subscribed categories: 3
Push: Email

Recommended plan

Professional

For research institutions and SaaS

Contact a consultant

Monthly requests: 50,000
Concurrency: Higher concurrency
Subscribed categories: 5
Data delivery: Webhook / CSV

Enterprise

For platforms, data companies and large enterprises

Contact a consultant

Monthly requests: High-volume usage
Data delivery: Incremental data push
Customisation: Field / dataset
Technical support: Enterprise technical support

The questions worth confirming before integrating a bulk agricultural import data API

Straight answers on public reports, reporting period definitions, update frequency and commercial integration.

The report data is public — why do I still need this API?

If you only need to read a report occasionally, the official MoC Department of Foreign Trade channel is enough. GooFuture is built for teams that need continuous monitoring, cross-period analysis, system integration and unified definitions — parsing import shipment, arrival and forecast data scattered across multiple PDF / HTML reports into structured time series you can get in one call.

Where does the data come from?

Data comes from the Bulk Agricultural Products Import Reports publicly issued by the Department of Foreign Trade, Ministry of Commerce of the People's Republic of China. Coverage spans five categories — sugar, dairy, oils and oilseeds, meals and meat — one issue per fortnight in PDF / HTML. GooFuture collects, parses, cleans, standardises, links and aggregates the raw reports and delivers them via API.

How often is the data updated?

Reports are published fortnightly (data as of the 15th and month end) by the MoC Department of Foreign Trade. We sync after each new issue; the latest sugar report covers data as of 2026-06-15 and was published on 2026-07-28.

Which fields can I query?

The import report lookup API returns report category, reporting period, sub-category, import shipment volumes (current period / month-to-date / next-month forecast), import arrival volumes (current period / month-to-date / next-month forecast), unit (tonnes) and arrival breakdown by customs office.

What do the current period / month-to-date / next-month forecast definitions mean?

The reports are based on importer-reported data: "current period" is the actual shipment / arrival within the reporting period, "month" is the calendar-month cumulative, and "next-month forecast" is importers’ forecast shipment / arrival volume for the following month. The API returns them under unified definitions for trend and arrival timing analysis.

How are you different from the official report publishers?

The official reports are published as PDF / HTML, one issue at a time, with no direct system integration. GooFuture parses the reports, normalises definitions and standardises categories into a single call, with time series, by-customs data and subscription push. All raw data comes from public reports.

Can I integrate the data into my own research / SaaS product?

Yes. The API can be used in internal systems and integrated into market research, supply chain and trade SaaS products; commercial usage is governed by the applicable plan and service agreement.

Which agricultural categories are covered?

Coverage spans the five categories in the MoC Department of Foreign Trade Bulk Agricultural Products Import Reports: sugar, dairy, oils and oilseeds, meals and meat. Each is further broken down (for example meat includes beef, mutton, pork and their by-products).

You no longer download, read and key in PDF reports issue by issue yourself.

From collecting the public reports to shipment/arrival parsing, definition normalisation and reporting period linking — we handle it all. Your systems just call the API.

Enterprise consultant onboarding · REST API · JSON responses

China Bulk Agricultural Products Import Report API

Report search key 3

Master report entity parsed

Data is scattered

Format: PDF / HTML

Inconsistent definitions

Maintenance costs keep piling up

Collect

Parse

Normalize

Relate

Aggregate

Deliver

Import report lookup API

Time series by sub-category API

Arrival by customs office API

Latest report API

Batch subscription and push API

Grain, oil / agricultural traders

Futures / research institutions

Supply chain / logistics

Trade / information SaaS

Data and research firms

The import report API supports further analysis

Structured report

Definition normalisation

Category standardisation

Reporting period marker

Fortnightly sync

Contact a consultant

Confirm the plan

Start integration

You no longer download, read and key in PDF reports issue by issue yourself.