Checking status…
Catalog / Comtrade
comtrade

Comtrade

Metadata onlyLicense under review

UN Comtrade — annual total merchandise trade (imports/exports) for 200+ countries. License: CC BY 3.0 IGO Source: https://comtradeapi.un.org/ No API key required (public preview endpoint, free tier). Coverage: * Annual total merchandise trade (imports CIF, exports FOB) * ~200 reporting countries ×…

Metadata only. This source’s license does not permit redistribution, so we catalog its metadata but do not re-serve the data. Use the provider link to obtain it under the original terms.

Coverage

Series catalogued
713
Temporal coverage
2014-12-31 – 2025-12-31

Licensing & provenance

License
License under review
Redistribution
Not permitted (metadata only)
Commercial use
Restricted / no
Modification
Permitted

How to cite

United Nations — UN Comtrade (UN Statistics Division). Retrieved from https://comtradeplus.un.org. Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from the official source, normalized to a long {series_key, obs_date, value} schema (period-start dates), de-duplicated, and stored as zstd Parquet. Compiled and redistributed by the Elkassabgi Data Library.

Access & mirrors

Download
Select & download comtrade series as CSV →
API
Get a free API key, then GET /v1/series/<id>.csv
Canonical landing
https://econdatalibrary.com/comtrade.html
Update cadence
annual
Update strategy
extend by date
Storage layout
single parquet (comtrade.parquet); 24,086 rows / 713 series; schema series_key(str), obs_date(date32, Dec-31 annual), value(float64); data spans 2014-12-31..2025-12-31

Full description

UN Comtrade — annual total merchandise trade (imports/exports) for 200+ countries. License: CC BY 3.0 IGO Source: https://comtradeapi.un.org/ No API key required (public preview endpoint, free tier). Coverage: * Annual total merchandise trade (imports CIF, exports FOB) * ~200 reporting countries × 2014–present * cmdCode=TOTAL (all goods aggregate) * Additional: total services trade, bilateral totals for major partners Rate limits: ~100 requests/hour on free tier; handled with 2s rate limiting. Run: python jobs/ingest_comtrade.py

Structured metadata

schema.org/Dataset (Google Dataset Search)
{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "Comtrade",
  "description": "UN Comtrade — annual total merchandise trade (imports/exports) for 200+ countries. License: CC BY 3.0 IGO Source: https://comtradeapi.un.org/ No API key required (public preview endpoint, free tier). Coverage: * Annual total merchandise trade (imports CIF, exports FOB) * ~200 reporting countries ×…",
  "url": "https://econdatalibrary.com/comtrade.html",
  "identifier": "comtrade",
  "isAccessibleForFree": false,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "creator": {
    "@type": "Organization",
    "name": "Comtrade"
  },
  "keywords": [
    "comtrade"
  ],
  "temporalCoverage": "2014-12-31/2025-12-31",
  "citation": "United Nations — UN Comtrade (UN Statistics Division). Retrieved from https://comtradeplus.un.org. Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-comtrade",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "usageInfo": "Metadata-only catalog entry. This source's license does not permit redistribution, so the data itself is not served here; use the provider link to obtain the data under its terms."
}
Croissant (ML-ready, schema.org JSON-LD)
{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "comtrade",
  "description": "UN Comtrade — annual total merchandise trade (imports/exports) for 200+ countries. License: CC BY 3.0 IGO Source: https://comtradeapi.un.org/ No API key required (public preview endpoint, free tier). Coverage: * Annual total merchandise trade (imports CIF, exports FOB) * ~200 reporting countries ×…",
  "url": "https://econdatalibrary.com/comtrade.html",
  "creator": {
    "@type": "sc:Organization",
    "name": "Comtrade"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "temporalCoverage": "2014-12-31/2025-12-31",
  "citation": "United Nations — UN Comtrade (UN Statistics Division). Retrieved from https://comtradeplus.un.org. Compiled and redistributed by the Elkassabgi Data Library.",
  "isAccessibleForFree": false,
  "usageInfo": "Metadata-only Croissant record; underlying data is not redistributed under this source's license."
}
Part of the Econ Data Library catalog · metadata generated 2026-07-14 from the central registry · browse all datasets
ElkassabgiData

One account. Every library.

HF Data Library  ·  Econ Data Library  · more to come