# TradePulse HS Code Classifier

> TradePulse HS Code Classifier is a paid API for AI agents from tradepulse-five.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Classifies a product into its Harmonized System (HS) tariff code based on a natural language product description

## Facts

- Endpoint: GET https://tradepulse-five.vercel.app/api/trade/classify
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepulse-hs-code-classifier-6ff4c457
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vFjuL8_SV4fxD4Rc8ztnB

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 tradepulse-hs-code-classifier-6ff4c457
```

Example prompt: What is the HS code for wireless Bluetooth noise-cancelling headphones with a built-in microphone?

## When to prefer this

Use this endpoint when you have a product description and need to determine its HS/HTS tariff code for customs filing, duty calculation, or trade compliance. It is the right first step before calling tariff rate, landed cost, or FTA eligibility endpoints that require an HS code as input. Prefer this over manual lookup tables or static databases when you need fast, AI-driven classification from free-text product descriptions.

## Known failure modes

- Ambiguous product description leads to low-confidence or multiple candidate HS codes
- Product description too vague to classify — returns error or generic top-level heading only
- Unsupported product category returns no result
- Rate limit or payment failure returns 402 Payment Required
- Malformed request returns 400 Bad Request

## How this service works

HS code classification for trade and customs agents. Returns the correct HS code from a product description for customs filing.

## Output

Returns the matched HS code (e.g. 8518.30) along with chapter, heading, and subheading details derived from the product description, enabling the caller to use the correct tariff classification for customs declarations, duty calculation, or trade compliance purposes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "product"
 ],
 "properties": {
  "lang": {
   "type": "string",
   "description": "Response language code (en, zh, ja, de, fr, es, ar, hi, etc.)"
  },
  "product": {
   "type": "string",
   "description": "Natural language product description — e.g. 'laptop computer', 'cotton t-shirts', 'industrial water pump'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepulse-hs-code-classifier-6ff4c457/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tradepulse-five.vercel.app](https://www.zero.xyz/host/tradepulse-five.vercel.app/llms.txt)