HS Codes API

Search and classify products using Harmonized System (HS) codes for international trade.

POST/api/v1/hs-codes/search

Search for HS codes by product description or keyword.

Request Body

{
  "query": "mobile phones",
  "limit": 10
}

Response

{
  "success": true,
  "data": {
    "results": [
      {
        "code": "8517",
        "description": "Telephone sets, incl. telephones for cellular networks",
        "fullDescription": "Electrical apparatus for line telephony or line telegraphy...",
        "chapter": "85",
        "chapterName": "Electrical machinery and equipment"
      },
      {
        "code": "851712",
        "description": "Telephones for cellular networks or for other wireless networks",
        "chapter": "85"
      }
    ],
    "total": 2
  }
}

GET/api/v1/hs-codes/:code

Get detailed information about a specific HS code including tariffs and trade data.

Path Parameters

Parameter	Type	Description
code	string	HS code (4-10 digits)

Response

{
  "success": true,
  "data": {
    "code": "8517",
    "description": "Telephone sets, including telephones for cellular networks",
    "chapter": "85",
    "chapterName": "Electrical machinery and equipment",
    "section": "XVI",
    "sectionName": "Machinery and mechanical appliances",
    "tradeData": {
      "globalExports": 45000000000,
      "globalImports": 43000000000,
      "topExporters": ["CN", "US", "DE"],
      "topImporters": ["US", "CN", "DE"]
    }
  }
}

GET/api/v1/hs-codes/:code/tariffs

Get tariff rates for a specific HS code across different countries.

Query Parameters

Parameter	Type	Description
country	string	ISO country code (optional)

Response

{
  "success": true,
  "data": {
    "hsCode": "8517",
    "tariffs": [
      {
        "country": "US",
        "countryName": "United States",
        "mfnRate": 0,
        "preferentialRates": {
          "USMCA": 0
        },
        "unit": "%"
      },
      {
        "country": "CN",
        "countryName": "China",
        "mfnRate": 13,
        "unit": "%"
      }
    ]
  }
}