China GACC Data API Guide: Customs Trade Data, HS Codes & CSV
Use GACC as the official customs source, then use China Data Portal for stable China trade JSON, CSV downloads, country pages, and HS product endpoints.
Developer quick start
Use the official source for verification. Use chinadata.live for stable JSON and CSV.
Many official China data portals publish statistics through web tables, Excel downloads, PDFs, release articles, or query systems rather than a stable public JSON API. China Data Portal turns selected official-source datasets into clean JSON and CSV endpoints.
Official source
General Administration of Customs of China (GACC)GACC publishes customs statistics through web pages, monthly releases, Excel-style tables, and the customs statistics query platform.
JSON / CSV
curl https://chinadata.live/api/v2/trade/country/united-states curl -L "https://chinadata.live/api/v2/trade/country/united-states?format=csv"
What Searchers Usually Need
Searches such as gacc api , china customs data api , china import export data api , or gacc customs statistics csv usually mix two jobs: locating the official source and getting a stable dataset for an app, spreadsheet, dashboard, or research workflow.
Use General Administration of Customs of China (GACC) for source verification
- Verify official country and HS trade totals.
- Check publication labels, units, and monthly release timing.
- Audit source definitions for exports, imports, partners, and commodity codes.
Use ChinaData.live for reusable outputs
- Fetch cleaned country trade pages and API responses.
- Use stable HS product routes for public Top 20 partner views.
- Download CSV-ready trade datasets without rebuilding GACC query logic.
Source caveat
The official customs tools are excellent for source verification, but they are not shaped like a simple public REST API for product apps, dashboards, or spreadsheet automation.
Available JSON and CSV Endpoints
These are China Data Portal endpoints built from selected official-source datasets. They are designed for repeatable analysis, source-aware dashboards, and spreadsheet workflows.
/api/v2/trade/country/united-states /api/v2/data/china-trade-monthly /api/v2/trade/hs/850760 /api/v2/data/china-trade-monthly API Examples
Every listed dataset supports JSON by default. Dataset endpoints also support CSV output by adding ?format=csv.
import requests
base = "https://chinadata.live"
json_data = requests.get(base + "/api/v2/trade/country/united-states", timeout=20).json()
csv_text = requests.get(base + "/api/v2/trade/country/united-states?format=csv", timeout=20).text
print(json_data["data"]["title"])
print(csv_text.splitlines()[0])Official Source vs China Data Portal
| Need | Official source | China Data Portal |
|---|---|---|
| Source authority | Primary official publisher | Independent cleaned dataset layer |
| Developer API | Often query pages, files, or releases | Stable JSON and CSV endpoints |
| Language and labels | Often Chinese-first or source-specific | English titles, units, slugs, and notes |
| Best use | Verification and audit trail | Applications, charts, CSV workflows |
FAQ
Does GACC provide official China customs statistics?
Yes. GACC is the official source for China customs statistics, including imports, exports, partner-country trade, and commodity-level releases.
Is there a simple GACC JSON API?
The official tools are source systems and query pages, not a simple documented REST API for most overseas app workflows. China Data Portal provides selected GACC-derived datasets as stable JSON and CSV endpoints.
Can I download China customs data as CSV?
Yes. China Data Portal exposes selected country, monthly, and HS trade datasets with CSV-style access and links back to the relevant source context.