Browse all documentation

Trade API: goods exports and imports by partner and product

Read a country's goods exports and imports by partner country and by HS product, month by month from 2010 where the source publishes it, with the source named on every answer.

Read a country's goods exports and imports by partner country and by HS product, month by month from 2010 where the source publishes it, with the source named on every answer.

What changed

  • Added GET /v1/trade/{country}/partners, GET /v1/trade/{country}/products, GET /v1/trade/{country}/products/{hs} and GET /v1/trade/flows, with the MCP tools trade_get_partners, trade_get_products, trade_get_product and trade_get_flows. Added GET /v1/trade/coverage (free) and GET /v1/trade/hs-codes and /hs-codes/{code}, with trade_get_coverage, trade_list_hs_codes and trade_get_hs_code.
  • Each answer names its source in basis: own for the country's own customs or statistics office, third_party for UN Comtrade (partner totals only), partner_reported for what other countries report about it, with the flows swapped. Own offices are the UK, the 27 EU members, the US, Canada, Mexico, Australia, Chile, Japan, Brazil, Norway, Switzerland, New Zealand and Thailand. Canada, Mexico and Australia give partner totals only.
  • Values are in the source's own currency. currency=USD converts each month with the monthly average rate and names the rate used. Products are HS codes of 2, 4 and 6 digits. top, share, ytd and change are options on the partner and product routes.
  • A call that returns at least one row is one call at $2 per 1,000 calls, and every page of a long answer is one call. An empty answer, every error and the coverage route are free.

All changelog entries ยท Changelog RSS feed

Was this page helpful?