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.

UN Comtrade publishes 6 APIs on the APIs.io network, including Bulk Download API, Data Availability API, Final Trade Data API, and 3 more. Tagged areas include Trade, International Trade, Import, Export, and Statistics.

The UN Comtrade catalog on APIs.io includes 1 Spectral governance ruleset.

📡 Source on GitHub

39.6/100 developing ▬ flat Agent 23/100 agent aware saas Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessFreemiumSelf serve⚡ Free to try

1 APIs

Trade International Trade Import Export Statistics United Nations Economics CommoditiesBilateral TradeHS CodesSITC

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 39.6/100 · developing

Contract Quality 13.7 / 25

Developer Ergonomics 5.7 / 20

Access Clarity 12.6 / 20

Operational Transparency 0.0 / 13

Contract Governance 1.2 / 12

Discoverability 6.3 / 10

Agent readiness — 23/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 4 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics does not apply to this provider. The published contracts declare no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's denominator entirely — not scored zero. A reference or data API is not deficient for being unable to upsert.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/un-comtrade: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

UN Comtrade Bulk Download API

Premium endpoints for bulk file downloads (up to 2.5M records via async processing).

UN Comtrade Data Availability API

Endpoints for discovering which countries/periods have submitted data.

UN Comtrade Final Trade Data API

Authenticated endpoints for full final trade data extraction (up to 250,000 records per call).

UN Comtrade Public Preview API

Public endpoints requiring no authentication — limited to 500 records.

UN Comtrade Reference Data API

Public reference data including country groups.

UN Comtrade Tariffline Data API

Tariffline-level trade data with 6-digit or national commodity code detail.

Open Collections 6

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

API Collection

OPEN COLLECTION

UN Comtrade Data Bulk Download API

OPEN COLLECTION

UN Comtrade Data Bulk Download Data Availability API

OPEN COLLECTION

UN Comtrade Data Bulk Download Final Trade Data API

OPEN COLLECTION

UN Comtrade Data Bulk Download Reference Data API

OPEN COLLECTION

UN Comtrade Data Bulk Download Tariffline Data API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Plans

6 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

UN Comtrade API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

UN Comtrade API Response Envelope

6 properties

JSON SCHEMA

UN Comtrade Trade Record

47 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Check Data Availability

4 fields

EXAMPLE

Get Bilateral Trade

4 fields

EXAMPLE

Preview Goods Exports

4 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Un Comtrade Authentication

apiKey · 1 scheme

SECURITY

Un Comtrade Domain Security

TLSv1.3 · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Un Comtrade Agentic Access

13 operations

13 operations · 0 acting

AGENTIC

Resources

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Source (apis.yml)

name: UN Comtrade
description: 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.
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
image: https://comtradeplus.un.org/favicon.ico
tags:
- Trade
- International Trade
- Import
- Export
- Statistics
- United Nations
- Economics
- Commodities
- Bilateral Trade
- HS Codes
- SITC
url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.23'
apis:
- aid: un-comtrade:un-comtrade-bulk-download-api
  name: UN Comtrade Bulk Download API
  description: Premium endpoints for bulk file downloads (up to 2.5M records via async processing).
  humanURL: https://comtradedeveloper.un.org/
  baseURL: https://comtradeapi.un.org
  tags:
  - Bulk Download
  properties:
  - type: OpenAPI
    url: openapi/un-comtrade-bulk-download-api-openapi.yml
  - type: Documentation
    url: https://uncomtrade.org/docs/un-comtrade-api/
  - type: DeveloperPortal
    url: https://comtradedeveloper.un.org/
  - type: Authentication
    url: https://uncomtrade.org/docs/api-subscription-keys/
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/finops/finops.yml
  - type: Signup
    url: https://comtradeplus.un.org/
  - type: Pricing
    url: https://shop.un.org/databases
  - type: Python SDK
    url: https://github.com/uncomtrade/comtradeapicall
  - type: R Package
    url: https://docs.ropensci.org/comtradr/
- aid: un-comtrade:un-comtrade-data-availability-api
  name: UN Comtrade Data Availability API
  description: Endpoints for discovering which countries/periods have submitted data.
  humanURL: https://comtradedeveloper.un.org/
  baseURL: https://comtradeapi.un.org
  tags:
  - Data Availability
  properties:
  - type: OpenAPI
    url: openapi/un-comtrade-data-availability-api-openapi.yml
  - type: Documentation
    url: https://uncomtrade.org/docs/un-comtrade-api/
  - type: DeveloperPortal
    url: https://comtradedeveloper.un.org/
  - type: Authentication
    url: https://uncomtrade.org/docs/api-subscription-keys/
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/finops/finops.yml
  - type: Signup
    url: https://comtradeplus.un.org/
  - type: Pricing
    url: https://shop.un.org/databases
  - type: Python SDK
    url: https://github.com/uncomtrade/comtradeapicall
  - type: R Package
    url: https://docs.ropensci.org/comtradr/
- aid: un-comtrade:un-comtrade-final-trade-data-api
  name: UN Comtrade Final Trade Data API
  description: Authenticated endpoints for full final trade data extraction (up to 250,000 records per call).
  humanURL: https://comtradedeveloper.un.org/
  baseURL: https://comtradeapi.un.org
  tags:
  - Final Trade Data
  properties:
  - type: OpenAPI
    url: openapi/un-comtrade-final-trade-data-api-openapi.yml
  - type: Documentation
    url: https://uncomtrade.org/docs/un-comtrade-api/
  - type: DeveloperPortal
    url: https://comtradedeveloper.un.org/
  - type: Authentication
    url: https://uncomtrade.org/docs/api-subscription-keys/
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/finops/finops.yml
  - type: Signup
    url: https://comtradeplus.un.org/
  - type: Pricing
    url: https://shop.un.org/databases
  - type: Python SDK
    url: https://github.com/uncomtrade/comtradeapicall
  - type: R Package
    url: https://docs.ropensci.org/comtradr/
- aid: un-comtrade:un-comtrade-public-preview-api
  name: UN Comtrade Public Preview API
  description: Public endpoints requiring no authentication — limited to 500 records.
  humanURL: https://comtradedeveloper.un.org/
  baseURL: https://comtradeapi.un.org
  tags:
  - Public Preview
  properties:
  - type: OpenAPI
    url: openapi/un-comtrade-public-preview-api-openapi.yml
  - type: Documentation
    url: https://uncomtrade.org/docs/un-comtrade-api/
  - type: DeveloperPortal
    url: https://comtradedeveloper.un.org/
  - type: Authentication
    url: https://uncomtrade.org/docs/api-subscription-keys/
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/finops/finops.yml
  - type: Signup
    url: https://comtradeplus.un.org/
  - type: Pricing
    url: https://shop.un.org/databases
  - type: Python SDK
    url: https://github.com/uncomtrade/comtradeapicall
  - type: R Package
    url: https://docs.ropensci.org/comtradr/
- aid: un-comtrade:un-comtrade-reference-data-api
  name: UN Comtrade Reference Data API
  description: Public reference data including country groups.
  humanURL: https://comtradedeveloper.un.org/
  baseURL: https://comtradeapi.un.org
  tags:
  - Reference Data
  properties:
  - type: OpenAPI
    url: openapi/un-comtrade-reference-data-api-openapi.yml
  - type: Documentation
    url: https://uncomtrade.org/docs/un-comtrade-api/
  - type: DeveloperPortal
    url: https://comtradedeveloper.un.org/
  - type: Authentication
    url: https://uncomtrade.org/docs/api-subscription-keys/
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/finops/finops.yml
  - type: Signup
    url: https://comtradeplus.un.org/
  - type: Pricing
    url: https://shop.un.org/databases
  - type: Python SDK
    url: https://github.com/uncomtrade/comtradeapicall
  - type: R Package
    url: https://docs.ropensci.org/comtradr/
- aid: un-comtrade:un-comtrade-tariffline-data-api
  name: UN Comtrade Tariffline Data API
  description: Tariffline-level trade data with 6-digit or national commodity code detail.
  humanURL: https://comtradedeveloper.un.org/
  baseURL: https://comtradeapi.un.org
  tags:
  - Tariffline Data
  properties:
  - type: OpenAPI
    url: openapi/un-comtrade-tariffline-data-api-openapi.yml
  - type: Documentation
    url: https://uncomtrade.org/docs/un-comtrade-api/
  - type: DeveloperPortal
    url: https://comtradedeveloper.un.org/
  - type: Authentication
    url: https://uncomtrade.org/docs/api-subscription-keys/
  - type: Plans
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/plans/plans.yml
  - type: RateLimits
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/rate-limits/rate-limits.yml
  - type: FinOps
    url: https://raw.githubusercontent.com/api-evangelist/un-comtrade/refs/heads/main/finops/finops.yml
  - type: Signup
    url: https://comtradeplus.un.org/
  - type: Pricing
    url: https://shop.un.org/databases
  - type: Python SDK
    url: https://github.com/uncomtrade/comtradeapicall
  - type: R Package
    url: https://docs.ropensci.org/comtradr/
common:
- type: AgenticAccess
  url: agentic-access/un-comtrade-agentic-access.yml
contact:
- FN: UN Comtrade Support
  email: comtrade@un.org
- FN: UN Comtrade Subscriptions
  email: subscriptions@un.org
links:
- rel: self
  href: https://comtradeplus.un.org/
- rel: developer-portal
  href: https://comtradedeveloper.un.org/
- rel: documentation
  href: https://uncomtrade.org/docs/
- rel: pricing
  href: https://shop.un.org/databases
- rel: sign-up
  href: https://comtradeplus.un.org/
- rel: python-sdk
  href: https://github.com/uncomtrade/comtradeapicall
- rel: r-package
  href: https://docs.ropensci.org/comtradr/

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/un-comtrade"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/un-comtrade/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/un-comtrade/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.