Primary Value
primary_value
Optional
Primary trade value, USD -- CIF for imports, FOB for exports
UN Comtrade Bilateral Trade Statistics Scraper
Pricing
from $0.80 / 1,000 record scrapeds
Pull bilateral merchandise trade statistics from UN Comtrade's official API. Select reporters, trading partners, years, import/export flows and HS commodity detail (chapter to 6-digit); every row ships with human-readable reporter, partner and commodity names plus reported-vs-estimated flags.
Reporter Code
reporter_code
Optional
UN M49 numeric reporter code
Reporter Iso
reporter_iso
Optional
Reporter ISO3 code (reference join -- the API itself returns this null)
Reporter Desc
reporter_desc
Optional
Reporter country/territory name (reference join -- the API itself returns this null)
Partner Code
partner_code
Optional
UN M49 numeric partner code
Partner Iso
partner_iso
Optional
Partner ISO3 code (reference join -- the API itself returns this null)
Partner Desc
partner_desc
Optional
Partner country/territory name (reference join -- the API itself returns this null)
Period
period
Optional
Period string -- YYYY for annual, YYYYMM for monthly
Ref Year
ref_year
Optional
Reference year
Ref Month
ref_month
Optional
Reference month (52 for an annual period)
Freq Code
freq_code
Optional
A (annual) or M (monthly)
Flow Code
flow_code
Optional
M / X / RM / RX
Flow Desc
flow_desc
Optional
Flow description (reference join)
Classification Code
classification_code
Optional
HS classification vintage in force for this row (e.g. H6)
Cmd Code
cmd_code
Optional
Commodity code -- TOTAL, or an HS chapter/heading/subheading code
Cmd Desc
cmd_desc
Optional
Commodity description (reference join)
Aggr Level
aggr_level
Optional
Digit-depth of the commodity code (0 = TOTAL, 2/4/6 = HS digits)
Is Leaf
is_leaf
Optional
True when this commodity code has no finer breakdown beneath it
Qty
qty
Optional
Quantity in the reported unit
Qty Unit Code
qty_unit_code
Optional
Numeric code for the quantity unit
Qty Unit Abbr
qty_unit_abbr
Optional
Quantity unit abbreviation (reference join)
Net Wgt
net_wgt
Optional
Net weight, kg
Gross Wgt
gross_wgt
Optional
Gross weight, kg
Cif Value
cif_value
Optional
CIF value, USD (imports)
Fob Value
fob_value
Optional
FOB value, USD (exports)
Primary Value
primary_value
Optional
Primary trade value, USD -- CIF for imports, FOB for exports
Is Reported
is_reported
Optional
True when the reporter itself filed this figure (false = mirrored/estimated from the partner side)
Is Aggregate
is_aggregate
Optional
True when this row is an aggregate rather than a directly reported line
Legacy Estimation Flag
legacy_estimation_flag
Optional
UN Comtrade's legacy estimation-method flag
Customs Code
customs_code
Optional
Customs procedure code
Mot Code
mot_code
Optional
Mode-of-transport code