Skip to content
UN Comtrade Help Center

UN Comtrade Help Center

  • UN Comtrade website

Getting Started

  • Welcome to UN Comtrade
  • Read Me First (Disclaimer)
  • Use Cases
  • How to Access UN Comtrade data?
  • Subscription Plans
  • UN Comtrade Data Processing and Dissemination Pipeline
  • Policy on use and re-dissemination
  • Premium Subscribers
  • How to create an account
  • Acquiring API Subscription Keys
  • Who do we contact for support?
  • Can I book a demo of the UN Comtrade platform?

FAQ

  • Policy on use and re-dissemination
  • FAQs on Use and Re-dissemination
  • List of References & Parameter Codes
  • Exports from one country may not always align perfectly with the imports of its trading partners.
  • Bilateral asymmetries
  • Issues with UN Comtrade Website?
  • Annual totals vs sum of monthly data
  • Can I book a demo of the UN Comtrade platform?
  • Why are some converted datasets not accessible in the UI?
  • What is “SITC LTS”?
  • Why does the commodity description for some HS codes differ slightly from the official WCO version?
  • Trade valuation
  • How to Access UN Comtrade data?
  • Mode of Transport and Trade Routes
  • Does UN Comtrade provide buyer/supplier-level data?
  • How should I interpret and use quantity data in UN Comtrade?
  • What is bulk file download?
  • How do I use wildcards to query data?
  • How to use UN Comtrade via World Integrated Trade Solution (WITS)
  • What are the data sources for UN Comtrade?
  • Which new data items have been added to UN Comtrade datasets?
  • How to retrieve data for “World” exports to a country in UN Comtrade?
  • What is data preview?
  • What is data delivery?
  • Conversion factors and current/constant value
  • Supplementary Quantity Units
  • Are 6-digit commodity codes included in 4-digit commodity codes or are they separate?
  • Reported and Converted Data: Commodity Conversion Issues
  • Premium Trial Subscription
  • Who do we contact for support?
  • Showcases in Visualization Labs

Premium

  • Premium Subscribers
  • UN Comtrade Tools
  • Menu: Bulk Files

Metadata

  • Seaborne Trade Estimates – Archive
  • Country nomenclature and groupings
  • Historical Data 1900-1960 on IMTS
  • Correlation between ISIC and SITC codes (or Commodity and Industry)
  • Conversion factors and current/constant value
  • Which new data items have been added to UN Comtrade datasets?
  • What are the data sources for UN Comtrade?
  • Supplementary Quantity Units
  • Reporters and Partners
  • Taiwan, Province of China Trade Data
  • Data Conversion
  • Intermediate Goods in Trade Statistics
  • HS 2017 code 3002.19 and HS 2022 code 3822.19
  • HS 2007 code 2916.36
  • Monetary and Non-Monetary Gold in Trade Classifications (SITC, HS)
  • Areas not elsewhere specified
  • Why are China’s re-imports so high?
  • Second Partner Country
  • UN Comtrade and UNData
  • Tariffline product code description
  • Shuttle Trade
  • Trade with itself
  • Reporter country codes and their custom areas
  • Reported and Converted Data: Commodity Conversion Issues
  • Quantity unit information in detailed level data
  • Data Confidentiality in UN Comtrade
  • EU in UN Comtrade
  • Definition of luxury goods
  • Exports from one country may not always align perfectly with the imports of its trading partners.
  • Changes in trade reporting practices of countries with colonies
  • Reporting Period – Calendar Year
  • Measurement of iron trade, specifically in used cars
  • Leasing of aircraft – financial leasing
  • Hong Kong trade with China
  • Historical data on International Merchandise Trade Statistics (1900-1960)
  • Free Zones and Bunkers
  • Food provided on airlines – Transportation Services
  • Country Codes
  • China: Data availability before 1984
  • Italy: Change in Statistical Territory

Definitions

  • Trade valuation
  • Bilateral asymmetries
  • Special Trade System
  • Modes of Supply
  • Economic Territory and Statistical Territory
  • Distinction between Exports and Re-exports / Imports and Re-imports

Do more

  • UN Comtrade Tools
  • Developer tools for UN Comtrade Data

User Guide

  • How to create an account
  • Home page
  • Menu: Data
  • Menu: Data Availability
  • Menu: Bulk Files
  • Menu: Metadata
  • UN Comtrade Tools
  • UN Comtrade API
  • Showcases in Visualization Labs
  • Premium Trial Subscription
  • What is data preview?
  • What is data delivery?
  • What is tariffline data?
  • How to query data
  • How do I use wildcards to query data?
  • Downloading all data by period
  • How to use UN Comtrade via World Integrated Trade Solution (WITS)

Methodology and Manuals

  • Concepts and definitions of International Merchandise Trade Statistics
  • Concepts and definitions of Statistics of International Trade in Services
  • UN Comtrade Data Processing and Dissemination Pipeline
  • Compilation Methodology
  • Historical Data 1900-1960 on IMTS
  • IMTS Publication List
  • HS, SITC, BEC conversion and correspondence tables
  • Quantity and Weight Data in UN Comtrade

Trade in Services

  • Negative values in trade in services
  • Modes of Supply
  • EBOPS 2002: Extended Balance of Payments Services Classification
View Categories
  • Home
  • Docs
  • Getting Started
  • Acquiring API Subscription Keys

Acquiring API Subscription Keys

2 min read

To access the UN Comtrade API, you need to create an account on the UN Comtrade Developer Portal, obtain an API subscription key, and then use that key to make API requests to retrieve trade data.

To obtain a subscription key, please see steps below:

  • You must be a registered user of UN Comtrade before requesting an API subscription key. Please follow the steps in outlined in How to create a UN Comtrade account.
  • Visit the UN Comtrade Developer Portal at https://comtradedeveloper.un.org. Use your UN Comtrade account (registered email address in UN Comtrade) to sign in.
  • Browse through the products page: https://comtradedeveloper.un.org/products.
  • Select and click the API Product based on your UN Comtrade subscription tier:
    • Free APIs are available to UN Comtrade users with a free, basic individual account.
    • Premium Individual APIs are available to UN Comtrade users with a paid premium individual subscription.
    • Premium Institutional Pro APIs are available to UN Comtrade users with a paid premium institutional subscription.
    • Premium Trial APIs are available to UN Comtrade users with an existing premium trial account.
  • Provide a subscription name and click Subscribe.
  • After clicking “Subscribe”, the state would change to “Submitted”. For premium APIs, please allow us one (1) business day to issue the subscription key. For free APIs, the request is automatically approved; a subscription key is issued and can be used immediately.
  • IMPORTANT: You will receive a notification in your registered email that you have submitted a request for a subscription key. 
  • Subscription keys issued to users will be available under the user profile: https://comtradedeveloper.un.org/profile. Upon approval, the state would show “Active”. Click on the ‘Show’ link of the Primary key, and your subscription key will be shown.

  • Please review the API documentation for information on how to construct your API requests and explore the available data fields.
  • Begin using your API key to place requests and access the data you require.
  • You are invited to explore Developer tools for UN Comtrade provided “as-is” by the community:
    • UN Comtrade API Python Package For API examples at Github ComtradeAPICall.  
    • ComtradeR 
Share This Article :
  • Facebook
  • X
  • LinkedIn
How to create an accountWho do we contact for support?
© 2025 UN Comtrade Help Center • Built with GeneratePress