Import Export Trade Data Scraper - UN Comtrade Statistics (No API Key)

Scrape global import and export trade statistics for any country pair straight from the official UN Comtrade database. This international trade data scraper returns clean bilateral trade flows broken down by country, HS commodity code, trade value (USD), quantity and net weight — annual or monthly, with no API key, no login and no registration.

Perfect for trade intelligence, market-entry research, supply-chain analysis, competitor sourcing and economics dashboards. Export to JSON, CSV, Excel or Google Sheets, or pull it through the Apify API.

🔎 Keywords: import export data scraper, UN Comtrade API, international trade data, trade statistics scraper, HS code trade data, bilateral trade flows, customs trade data, commodity trade scraper.

---

What you get

One row per reporter × partner × commodity × period × flow:

• reporter / reporterISO — reporting country + ISO3 code
• partner / partnerISO — trading partner country + ISO3 code
• flow — Import or Export
• period — year (annual) or YYYYMM (monthly)
• hsCode / commodity — HS commodity code + description
• tradeValueUsd — trade value in USD
• cifValueUsd / fobValueUsd — CIF (imports) / FOB (exports) values
• netWeightKg — net weight in kg
• qty / qtyUnit — quantity & unit
• scrapedAt — ISO timestamp of the scrape

Sample output

{
  "reporter": "USA",
  "reporterISO": "USA",
  "partner": "China",
  "partnerISO": "CHN",
  "flow": "Import",
  "period": "2023",
  "hsCode": "85",
  "commodity": "Electrical machinery and equipment",
  "tradeValueUsd": "127845300000",
  "cifValueUsd": "127845300000",
  "netWeightKg": "4120500000",
  "qtyUnit": "N/A",
  "scrapedAt": "2026-06-03T08:30:11.000Z"
}

---

Use cases

• Market-entry research — see which countries buy a product and how much, before you enter a market.
• Competitor & supplier sourcing — find where a country imports a commodity from.
• Commodity trade trends — track import/export value over years or months.
• Supply-chain & tariff impact analysis — model how flows shift over time.
• Economics & BI dashboards — feed clean bilateral trade statistics into your reports.
• AI agents & data products — provide structured international trade data to LLM workflows.

---

How to use

1. Pick your countries — one or more reporter countries and partner countries (plain names or M49 codes).
2. Choose commodities, flow & period — HS codes or an aggregation, import/export/both, and the years or months you want.
3. Run & download — export as JSON, CSV or Excel, or fetch via the Apify API. Schedule it to refresh your trade datasets automatically.

Example — who do the USA & Germany import from China?

{
  "reporters": "USA, Germany",
  "partners": "China",
  "flow": "import",
  "commodities": "AG2",
  "periods": "2022-2023",
  "frequency": "A"
}

Input fields

Field	Description
reporters	Reporting country/countries — names, M49 codes, or all. Comma-separated.
partners	Trading partner(s) — names, codes, World (all combined), or all.
flow	import, export, or both.
commodities	Specific HS codes (8703,8517) or an aggregation: TOTAL, AG2, AG4, AG6.
periods	Year 2023, list 2021,2022, range 2020-2023, or monthly 202301-202312. Blank = last full year.
frequency	A (annual) or M (monthly).
maxResults	Maximum trade records to save.
throttleMs	Delay between API calls (keep ≥ 1100 for the keyless tier).

---

FAQ

Do I need a UN Comtrade API key?

No. This actor uses the keyless UN Comtrade preview tier — no registration, no key, no login.

Can I use plain country names?

Yes. Pass names like Germany, China, USA and the actor resolves them to the correct UN M49 codes automatically.

What are AG2, AG4, AG6?

HS aggregation levels — AG2 = all 2-digit HS chapters, AG4 = 4-digit headings, AG6 = 6-digit subheadings. You can also pass specific HS codes like 8703,8517.

Is this company- or shipment-level data?

No — this is statistical trade-flow data (country × commodity × value), the official UN Comtrade figures. It is not shipment-level bill-of-lading or company records.

Can I export to Excel / Google Sheets?

Yes. Download as JSON, CSV, Excel, HTML or RSS, or use the Apify API and integrations (Make, Zapier, Google Sheets).

---

Notes & best practices

• Data source: official UN Comtrade statistics (keyless preview tier).
• The keyless tier rate-limits to ~1 request/second and caps 500 records per query — the actor throttles and fans out across countries, commodities and periods automatically. Keep throttleMs ≥ 1100.
• For large jobs, split very broad queries (e.g. all reporters over many years) into smaller runs.

ℹ️ This is an independent scraper of publicly available UN Comtrade statistics and is not affiliated with or endorsed by the United Nations.

📝 Changelog

2026-06-05

• 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results).
• ⚡ Stability & performance hardening; fresh rebuild.

2026-06-04

• Verified live & refreshed build — reliability/maintenance pass.