Skip to content

Repository files navigation

UN Comtrade

About this repository

This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.

Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema, apis.json, llms.txt and similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.

The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.

Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.

  • Something wrong? Open an issue on this repository, or email info@apievangelist.com.
  • Published something new? Ask for a re-score and we will re-run the rating.
  • Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.

Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.

On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.

Full detail: Where this data comes from

United Nations international trade statistics database with a REST API for accessing import/export data, commodity trade flows, and bilateral trade statistics.

Overview

UN Comtrade is the world's most comprehensive trade data repository, maintained by the United Nations Statistics Division. It covers international merchandise and services trade statistics for over 200 reporting countries and territories, with data going back to 1962 for many reporters. Commodity data is classified using HS (Harmonized System), SITC (Standard International Trade Classification), and other recognized schemes.

API Access

The UN Comtrade API is available at https://comtradeapi.un.org and is managed through the UN Comtrade Developer Portal.

Authentication

  • No key required: Public preview endpoints, limited to 500 records per call
  • Free API key: Register at comtradeplus.un.org, then subscribe to the free product on the Developer Portal. Provides 500 calls/day with up to 100,000 records per call.
  • Premium key: Annual subscription starting at $2,000/year for individuals. Unlocks bulk downloads, async batch processing (up to 2.5M records), and higher call limits.

API keys are passed as the Ocp-Apim-Subscription-Key request header or as the subscription-key query parameter.

Key Endpoints

Endpoint Description Auth Required
GET /public/v1/preview/{type}/{freq}/{cl} Preview trade data (500 records max) No
GET /data/v1/get/{type}/{freq}/{cl} Extract final trade data Yes
GET /data/v1/getTariffline/{type}/{freq}/{cl} Extract tariffline data Yes
GET /data/v1/getDa/{type}/{freq}/{cl} Data availability Yes
GET /data/v1/getMetadata Reference metadata Yes
GET /data/v1/getLiveUpdate Recent publications Yes
GET /bulk/v1/get/{type}/{freq}/{cl} Bulk file links Premium
GET /bulk/v1/getTariffline/{type}/{freq}/{cl} Bulk tariffline files Premium
GET /bulk/v1/getClassic/{type}/{freq}/{cl} Classic format bulk files Premium

Path Parameters

  • {type}: C (Goods) or S (Services)
  • {freq}: A (Annual) or M (Monthly)
  • {cl}: Classification code — HS, H5, H4, H3, S3, S2, S1

Subscription Plans

Plan Annual Cost Calls/Day Records/Call
Free Preview $0 Unlimited 500
Free Registered $0 500 100,000
Premium Individual $2,000 5,000 250,000
Premium Institutional Pro 1 (non-profit/academic) $6,000 Unlimited 250,000
Premium Institutional Pro 2 (private sector) $12,000 Unlimited 250,000

Trial subscriptions are available. Contact subscriptions@un.org.

SDKs and Libraries

Resources

Contact

About

UN Comtrade — United Nations international trade statistics database with a REST API for accessing import/export data, commodity trade flows, and bilateral trade statistics. Covers over 200 reporting countries and territories with data spanning goods and services trade classified by HS, SITC, and other commodity codes.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors