Skip to main content
All providers

UN Comtrade

Statistics

comtradeapi.un.org

Official United Nations merchandise and services trade statistics: annual and monthly imports and exports by reporting country, partner country and product code, for around 200 reporters covering over 99% of world trade.

Runs on your machine under the source's own terms

The crw MCP on your computer calls UN Comtrade directly. Calls cost no credits and the data does not pass through fastCRW. Install it once for Claude Code, Cursor, Codex, Windsurf, Gemini CLI or OpenCode, with your fastCRW API key in place of the placeholder:

Capabilities (24)

uncomtrade/commoditiesFree, runs locally

Returns the full code tree for one product classification - every code with its description, parent code, aggregation level and whether it is a leaf node.

classification
uncomtrade/country-groupsFree, runs locally

Returns 42 country groupings - ASEAN, EU, OECD, LDCs, G20, ACP and others - each with its group id, full name and the list of member country codes.

No parameters
uncomtrade/country-iso-codesFree, runs locally

Returns the mapping between every UN Comtrade numeric country or area code and its ISO 3166-1 alpha-3 code, 312 entries including the underscore-prefixed pseudo-codes used for aggregates.

No parameters
uncomtrade/customs-proceduresFree, runs locally

Returns the 17 customs procedure codes and labels, such as clearance for home use, inward processing, temporary admission and re-exportation.

No parameters
uncomtrade/data-availabilityFree, runs locally

Returns whether a reporter and period exist in the standard dataset, with the total record count, the classification used, a dataset checksum and the first-released and last-released timestamps.

freqCodereporterCodeperiodpublishedDateFrom?publishedDateTo?
uncomtrade/data-itemsFree, runs locally

Returns the 50 field names that appear in trade responses, each with a plain-language definition and flags for whether it is present in the commodity dataset, the services dataset and the tariff-line dataset.

No parameters
uncomtrade/dataset-metadataFree, runs locally

Returns the compilation notes for one reporter and period: currency and conversion factors, trade system, import and export valuation basis, partner-country attribution rule, classification used, and the publication date history.

freqCodereporterCodeperiod
uncomtrade/frequenciesFree, runs locally

Returns the three frequency codes UN Comtrade uses and their labels: A annual, Q quarterly, M monthly.

No parameters
uncomtrade/goods-annualFree, runs locally

Returns up to 500 annual goods-trade records for one reporting country and year, each with trade value in USD, net weight, quantity, flow, partner country and HS commodity code with descriptions.

reporterCodeperiodpartnerCode?partner2Code?cmdCode?flowCode?motCode?customsCode?aggregateBy?breakdownMode?countOnly?
uncomtrade/goods-annual-becFree, runs locally

Returns up to 500 annual goods-trade records for one reporter and year classified by Broad Economic Categories Rev.5, which groups products by end use such as capital, intermediate and consumption goods.

reporterCodeperiodpartnerCode?partner2Code?cmdCode?flowCode?motCode?customsCode?aggregateBy?breakdownMode?countOnly?
uncomtrade/goods-annual-sitcFree, runs locally

Returns up to 500 annual goods-trade records for one reporter and year classified by SITC Revision 4 section and group rather than HS chapter.

reporterCodeperiodpartnerCode?partner2Code?cmdCode?flowCode?motCode?customsCode?aggregateBy?breakdownMode?countOnly?
uncomtrade/goods-monthlyFree, runs locally

Returns up to 500 monthly goods-trade records for one reporting country and month, with trade value in USD, net weight, quantity, flow, partner and HS commodity code with descriptions.

reporterCodeperiodpartnerCode?partner2Code?cmdCode?flowCode?motCode?customsCode?aggregateBy?breakdownMode?countOnly?
uncomtrade/partnersFree, runs locally

Returns all 310 partner countries, areas and aggregates with their numeric partnerCode, ISO alpha-2 and alpha-3 codes and whether the entry is a group such as World or an economic bloc.

No parameters
uncomtrade/quantity-unitsFree, runs locally

Returns the 41 quantity-unit codes used in the trade data, each with its abbreviation and description, including kilograms, litres, items and the 'not available' sentinel.

No parameters
uncomtrade/reference-tablesFree, runs locally

Returns the catalogue of every UN Comtrade code list, each with its category key, a description and the URL of the JSON file that holds it.

No parameters
uncomtrade/reportersFree, runs locally

Returns all 255 reporting countries and areas with their UN M49 numeric code, ISO alpha-2 and alpha-3 codes, the date the entry took effect and whether it is a group rather than a country.

No parameters
uncomtrade/services-annualFree, runs locally

Returns annual trade-in-services records for one reporter and year, valued in USD and classified by EBOPS 2002 service category such as transport, travel, insurance or telecommunications.

reporterCodeperiodpartnerCode?cmdCode?flowCode?aggregateBy?breakdownMode?countOnly?
uncomtrade/services-availabilityFree, runs locally

Returns whether a reporter and year exist in the trade-in-services dataset, with the record count, the EBOPS classification used, a dataset checksum and the first-released and last-released timestamps.

reporterCodeperiodpublishedDateFrom?publishedDateTo?
uncomtrade/supply-modesFree, runs locally

Returns the five GATS modes of supply used in services trade: all modes, cross-border, consumption abroad, commercial presence and presence of natural persons.

No parameters
uncomtrade/tariffline-annualFree, runs locally

Returns up to 500 annual records at the reporter's own national tariff-line detail - commodity codes of 8 to 12 digits rather than the 6-digit HS the standard dataset is cut to.

reporterCodeperiodpartnerCode?partner2Code?cmdCode?flowCode?motCode?customsCode?countOnly?
uncomtrade/tariffline-availabilityFree, runs locally

Returns whether a reporter and period exist in the tariff-line dataset, with its record count, the length of the national commodity code and the release timestamps.

freqCodereporterCodeperiodpublishedDateFrom?publishedDateTo?
uncomtrade/tariffline-monthlyFree, runs locally

Returns up to 500 monthly records at the reporter's national tariff-line detail for one reference month, with value, weight, quantity, partner and customs procedure.

reporterCodeperiodpartnerCode?partner2Code?cmdCode?flowCode?motCode?customsCode?countOnly?
uncomtrade/trade-flowsFree, runs locally

Returns the ten flow codes and their meanings - import, export, re-import, re-export, domestic export and the intellectual-property flows.

No parameters
uncomtrade/transport-modesFree, runs locally

Returns the 18 mode-of-transport codes and labels, from the 0 total down to air, water, rail, road, pipeline and postal, including sub-codes such as sea and inland waterway.

No parameters

Licence

UN Comtrade data are provided for internal use only and may not be re-disseminated in any form without UNSD’s permission.

https://uncomtrade.org/docs/policy-on-comtrade-data-use/

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attributionText.

Source: UN Comtrade (United Nations Statistics Division). UN Comtrade data are copyright of the United Nations; re-dissemination requires UNSD permission.