EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

trade

Product trade series

https://docs.economicsapi.com/endpoints/getproducthistory
gethttps://api.economicsapi.com/v1/trade/products/{pid}/history

Annual trade series for one product, optionally filtered by reporter/partner and flow direction.

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

Authorization

Authorizationstringheaderrequired

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

Path parameters

pidstringrequired

Query parameters

reporterstring | null
partnerstring | null
flowstring | null
fromstring | null
tostring | null

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
}