# SiteCheck Trade & Energy – HS Code Classifier

> SiteCheck Trade & Energy – HS Code Classifier is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Searches UN Comtrade's official HS reference list by code prefix or keyword to return candidate Harmonized System headings and subheadings with descriptions and hierarchy levels.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/logistics/hs-code-classifier?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-hs-code-classifier-60a7901f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2tjpgLHHYehb0TSMtqOA5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-trade-energy-hs-code-classifier-60a7901f
```

Example prompt: Can you search the UN Comtrade HS reference list for 'solar panels' and give me the top 5 candidate headings and subheadings with their official descriptions and hierarchy levels?

## When to prefer this

Choose this endpoint when you need to discover candidate Harmonized System codes from the authoritative UN Comtrade reference by either a numeric prefix or a plain-language product keyword. It is ideal for trade compliance research, export/import classification assistance, and supply chain tooling where you need official HS descriptions and hierarchy levels. It does not determine the legally binding tariff code for a specific shipment — use it as a shortlisting and research tool, not a final classification authority.

## Known failure modes

- No matches found for obscure or misspelled keywords — returns count 0 with empty matches array
- Query too short or ambiguous may return unrelated headings spanning multiple chapters
- Limit parameter out of range (outside 1–20) may default or return an error
- UN Comtrade upstream data unavailable may cause timeout or 5xx error
- HS code prefix with non-numeric characters returns no results

## How this service works

Finds Harmonized System (HS) codes from UN Comtrade's HS reference list by code prefix or description keyword: code, official description, hierarchy level. It lists candidate headings and subheadings; it does not decide the legal tariff code for a shipment.

## Output

Returns a JSON object with the query string, total match count, source URL (UN Comtrade HS reference), checked timestamp, and an array of matches each containing the HS code, its official UN description, hierarchy level (e.g. 4 for heading, 6 for subheading), and a leaf flag indicating whether it is a terminal subheading.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "HS code digits (e.g. 8703) or a keyword (e.g. motor cars)"
      },
      "limit": {
       "type": "string",
       "description": "1 to 20, default 5"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 4,
  "query": "motor cars",
  "source": "https://comtradeapi.un.org/files/v1/app/reference/HS.json",
  "matches": [
   {
    "leaf": false,
    "level": 4,
    "hsCode": "8703",
    "description": "Motor cars and other motor vehicles; principally designed for the transport of persons (other than those of heading no. 8702), including station wagons and racing cars"
   },
   {
    "leaf": true,
    "level": 6,
    "hsCode": "401110",
    "description": "Rubber; new pneumatic tyres, of a kind used on motor cars (including station wagons and racing cars)"
   }
  ],
  "checkedAt": "2026-10-23T09:37:56.757Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-hs-code-classifier-60a7901f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)