EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

trade

Country trading partners

https://docs.economicsapi.com/endpoints/getcountrypartners
gethttps://api.economicsapi.com/v1/trade/countries/{cid}/partners

A country's partners ranked by trade value, for either flow direction, optionally per product.

curl -X GET "https://api.economicsapi.com/v1/trade/countries/example/partners" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx"

Authorization

Authorizationstringheaderrequired

Bearer token. API key from your economicsapi dashboard Format: `Bearer sk_live_xxxxxxxxxxxxxxxxxxxx`.

Path parameters

cidstringrequired

Query parameters

flowstring | null
productstring | null
fromstring | null
tostring | null
limitintegerdefault 50

min 1 · max 500

Response

200Successful Responseapplication/json
dataGroupedPoint[]required
request_idstringdefault ""
duration_msintegerdefault 0
401Missing or invalid API keyapplication/json
errorstring
messagestring
request_idstring
422Validation Errorapplication/json
detailValidationError[]
429Rate limit exceededapplication/json
errorstring
messagestring
request_idstring
Response
{
  "data": [
    {
      "period": "2026-01-01",
      "partner": "example",
      "exporter": "example",
      "importer": "example",
      "hs6": "example",
      "value_usd": 0,
      "quantity": 0,
      "flow_count": 3
    }
  ],
  "request_id": "",
  "duration_ms": 0
}