Search commodities

Resolve a product description or HS code prefix to 4-digit HS headings with common goods, estimated import value, and importer counts.

POST /trade_intel/commodities/search

cURL

By description

curl --request POST \
  --url https://api.terminal49.com/v2/trade_intel/commodities/search \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "laptops"
}
'

200

{
  "results": [
    {
      "hs4": "9401",
      "description": "Seats (other than barber, dental, etc), and part",
      "estimated_value": 9800000000,
      "companies": 4200,
      "common_goods": [
        "office chairs",
        "sofas",
        "car seats"
      ],
      "score": 0.91
    }
  ]
}

Authorizations

Authorization · string · header · required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Body

application/json

query · string · required

Product description in plain words, or an HS code prefix.

Required string length: 1 - 200

Example:

"office chairs"

limit · integer · default: 10

Maximum results to return.

Required range: 1 <= x <= 50

Response

200

application/json

OK

results · object[] · required

Matches ordered by score.

Show child attributes