trademap.org APItrademap.org ↗
Access ITC Trade Map data via API: bilateral trade flows, export/import indicators, HS-code time series, and data availability for 200+ countries.
curl -X GET 'https://api.parse.bot/scraper/ce6950bd-1895-499a-828c-3af9bf6a7c80/get_trade_indicators?hs_code=TOTAL&trade_flow=4&reporter_code=842' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve trade indicators (export value, trade balance, growth, share, etc.) for a specific product and country. Returns a list of countries with their trade performance metrics.
| Param | Type | Description |
|---|---|---|
| hs_code | string | HS product code (e.g. '8471'). Use 'TOTAL' for all products. |
| trade_flow | string | Trade flow direction. Accepted values: '2' for Export, '4' for Import. |
| partner_code | string | Partner country code. Empty string for all partners. |
| reporter_code | string | Reporter country code (e.g. '842' for USA). |
{
"type": "object",
"fields": {
"data": "array of objects, each containing country name (Exporters), trade values, growth rates, share percentages, and concentration metrics"
},
"sample": {
"data": {
"data": [
{
"Exporters": "World",
"Share in world exports (%)": "100",
"Concentration of importing countries": "0.04",
"Trade balance in 2025 (USD thousand)": "-171,727,803",
"Value exported in 2025 (USD thousand)": "25,636,648,695",
"Annual growth in value between 2021-2025 (%)": "3",
"Annual growth in value between 2024-2025 (%)": "8",
"Average distance of importing countries (km)": "5,103"
}
]
},
"status": "success"
}
}About the trademap.org API
The Trade Map API exposes 5 endpoints covering global trade statistics sourced from ITC Trade Map, including country-level trade indicators, yearly time series, and bilateral trade flows. The get_trade_indicators endpoint returns per-country metrics such as export value, trade balance, growth rates, world share, and concentration indices filtered by HS product code and trade flow direction. Together the endpoints span product-level breakdowns from HS-2 through HS-6 digit classification.
Trade Indicators and Time Series
The get_trade_indicators endpoint accepts an hs_code (e.g. '8471' for computers, or 'TOTAL' for all products), a trade_flow value ('2' for exports, '4' for imports), and optional reporter_code and partner_code to filter by specific countries. Each record in the response includes the country name (Exporters), trade values, year-on-year growth rates, world share percentages, and concentration metrics. The get_yearly_time_series endpoint uses the same parameter set and returns a multi-year array of export or import values per country, suitable for trend analysis.
Product and Bilateral Breakdowns
get_products_by_country lets you query a specific country's trade profile at HS-2, HS-4, or HS-6 digit granularity by setting hs_level. Each row returns the HS code, product label, and imported or exported values across recent years. get_bilateral_trade narrows to a single country-pair: supply a reporter_code (e.g. '842' for the USA) and a partner_code (e.g. '156' for China) to get a product-level breakdown including bilateral trade values, the partner's exports to the world, and the reporter's imports from the world.
Data Availability
The get_data_availability endpoint takes no inputs and returns a matrix of countries by year, where each cell is a numeric code indicating whether the data for that country-year is based on directly reported figures or mirror statistics (data reported by trading partners). This is useful for assessing confidence in specific data points before building downstream analyses.
- Track year-over-year export growth for a specific HS-4 product across all reporting countries using
get_yearly_time_series. - Identify top trading partners for a given commodity by filtering
get_trade_indicatorsbyhs_codeandtrade_flow. - Compare a country's full import product mix at HS-6 digit level using
get_products_by_countrywithhs_level='6'. - Analyze bilateral trade flows between the USA and China for semiconductor products using
get_bilateral_tradewith codes'842'and'156'. - Audit data reliability before building trade dashboards by checking per-country reporting status in
get_data_availability. - Calculate market share concentration for a product category across exporters using the concentration metrics in
get_trade_indicators. - Build a trade balance monitor by querying both export (
'2') and import ('4') flows for the same HS code and reporter.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ITC Trade Map have an official developer API?+
What does `get_bilateral_trade` return beyond simple trade values?+
What do the numeric codes in `get_data_availability` mean?+
Does the API expose sub-annual (monthly or quarterly) trade data?+
get_yearly_time_series and get_products_by_country endpoints both provide values at a yearly granularity. You can fork this API on Parse and revise it to add a monthly trade series endpoint if that granularity is available from the source.