HS Code Classification API
Send a product name in natural language and get back HS code candidates and duty rates by country as JSON. This exposes the exact same search logic this site's search page uses — anything you can find on the site, you can find through the API.
Endpoint
GET /api/v1/classify — call it after subscribing on the RapidAPI marketplace.
| Parameter | Required | Description |
|---|---|---|
q | Yes | Product name in natural language (max 200 chars). You can also enter an HS code (4-10 digits) directly. |
lang | No | ko / ja / en (default ko) |
countries | No | Comma-separated country codes. Defaults to kr. FTA partner codes (us, eu, cn, jp, etc.) are also supported. |
limit | No | Number of candidates to return, 1-5 (default 5) |
Example request
curl "https://korea-hs-code-classification-api.p.rapidapi.com/api/v1/classify?q=wireless+earbuds&lang=en&countries=kr" \
-H "X-RapidAPI-Key: <key issued after you subscribe>" \
-H "X-RapidAPI-Host: korea-hs-code-classification-api.p.rapidapi.com"X-RapidAPI-Key is issued automatically once you subscribe on RapidAPI. Parameters and the response shape are the same as above.
Pricing
| Plan | Price | Monthly call limit |
|---|---|---|
| Free | $0 | 50 calls / month |
| PRO | $9.99 | 1,000 calls / month |
| ULTRA | $49.99 | 10,000 calls / month |
Accuracy and limitations
Measured on a 28-item answer set: top1 accuracy 64% · top5 recall 93%. The score field in the response is a search ranking score, not a classification confidence probability.
The tariff headings and rates this API returns are reference information derived from Korea Customs Service open data and have no legal effect.Verify with a licensed customs broker or the Korea Customs Service before relying on them for an actual import.
Contact
For API questions or bug reports, please write to help@pix-make.com.