Sign up
All data sources

UN Comtrade

Free

Global bilateral trade flows by commodity: crude, refined products, LNG/LPG, coal.

Set up this sourceGet the full contract and schemas as JSONConnect this source →

No key required. Included on Free.

What you can ask

  • “What does UN Comtrade have for the area or asset I'm working on?”
  • “Pull the most recent UN Comtrade records and put them in a table.”
  • “What does UN Comtrade cover, and how fresh is the data?”

About this source

UN Comtrade — global bilateral trade flows (free preview tier). No auth. DATA: getTradeFlows (trade value + weight by reporter, partner, commodity, period). Energy HS codes: 2709 crude, 2710 refined, 2711 petroleum gases (LNG/LPG), 2701 coal, 2716 electricity. RULES: 1. reporterCode/partnerCode are UN M49 numeric codes (842=USA, 0=World, 156=China). period = YYYY (annual) or YYYYMM (monthly). flowCode M=import, X=export. 2. Preview tier is row-capped; descriptions may be null (codes only). Additive to census-trade (US-only).

Connector ID comtrade

Provenance

PublisherUnited Nations Comtrade
Sourcehttps://comtradeplus.un.org/
API basehttps://comtradeapi.un.org/public/v1/preview
Docshttps://comtradeapi.un.org/

Freshness & coverage

FreshnessScheduled — Availability follows each reporter and period published by UN Comtrade.
GeographicGlobal bilateral trade reported by UN Comtrade participants
TemporalNot declared
AuthenticationNo credentials required

Caveats

  • ⚠ The credential-free preview endpoint is row-capped; results are explicitly marked incomplete.
  • ⚠ Country and commodity descriptions may be null on the preview tier; numeric M49 and HS codes remain authoritative.

› Methods (2)

Technical detail for developers: parameters, pagination, units, and freshness per method.

  • getTradeFlows

    read

    Bilateral trade flows by reporter, partner, HS commodity, period (value in USD, weight in kg).

    Required paramsreporterCodeperiod
    Entitiesbilateral trade flow, commodity, country
    Paginationnone
    Unitsrows[].tradeValueUsd: USD · rows[].cifValueUsd: USD · rows[].fobValueUsd: USD · rows[].netWeightKg: kg · rows[].grossWeightKg: kg
    FreshnessScheduled (source-level)
    • ⚠ The public preview is row-capped and complete is always false.

  • getServiceInfo

    read

    Energy HS codes, flow codes, common country codes, and preview-tier caveats.

    Entitiesservice metadata
    Paginationnone
    FreshnessScheduled (source-level)