/comtrade/trades/search
Search UN Comtrade international trade records by reporter, partner, commodity, flow and period
Price: 5 credits per 500 results
💡 AI Hint: Search UN Comtrade international trade statistics — import/export values and quantities between countries broken down by reporter area, partner area, commodity code and time period. Filter by reporter_code and partner_code (numeric area codes, look them up via the reporters/partners endpoints), cmd_code (commodity code, TOTAL for all goods), flow_code (M=import, X=export), classification (HS/SITC/BEC) and period (year or year-month). Each record carries trade values (primary, CIF, FOB), net/gross weight, quantity with its unit, and descriptive labels for every code.
Authorizations
API token from the dashboard
Headers
Body
Number of trade records to return
1 <= x <= 500Max scrapping execution timeout (in seconds)
20 <= x <= 1500Trade type — goods (C) or services (S)
C, S Frequency — annual (A) or monthly (M)
A, M Commodity/service classification scheme
HS, H0, H1, H2, H3, H4, H5, H6, SITC, S1, S2, S3, S4, ST, BEC, B4, B5, EB, EB02, EB10, EB10S Reporter area code(s), comma-separated (M49/UN numeric). Look up via the reporters endpoint
"842"
Partner area code(s), comma-separated. 0 = World. Use the partners endpoint to look up codes
"156"
Second partner area code(s) for re-export/re-import breakdown, comma-separated
Commodity code(s), comma-separated. TOTAL = all commodities; AG2/AG4/AG6 = aggregation levels
"TOTAL"
Trade flow direction — import (M), export (X), re-export (RX), etc.
M, X, DX, FM, MIP, MOP, RM, RX, XIP, XOP Customs procedure code(s), comma-separated. C00 = TOTAL customs procedures
"C00"
Mode of transport code(s), comma-separated. 0 = TOTAL modes of transport
"3200"
Period(s), comma-separated. Year (YYYY) for annual, year-month (YYYYMM) for monthly
"2022"
Response
Successful Response