贸易合规 API。
一个接口完成商品归类，一个接口完成多市场价格测算。REST、OpenAPI 3.1，并提供 Node、Python、Go、Ruby SDK。
一次调用
三行代码归类一个商品。
给我们一段描述、一张图片链接或电商商品页 URL,我们返回最多 3 个候选 HS 编码,附带置信度、多市场关税以及用于推理的 CBP CROSS 裁定。中位响应时间 340 ms。
系统运行正常 · 99.97% 可用性 · status.hscodelab.com
# Classify a product from a text description curl https://api.hscodelab.com/v1/classify \ -H "Authorization: Bearer $HSCODELAB_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "description": "Wireless Bluetooth headphones, over-ear, with noise cancelling", "origin": "CN", "destination": "US" }'
接口
六个端点。其余都是参数。
POSTapi.hscodelab.com/v1/classify通过文本、图片或链接归类商品
GETapi.hscodelab.com/v1/hs/{code}获取 HS 编码完整信息与关税
POSTapi.hscodelab.com/v1/calculate计算货件的到岸成本
GETapi.hscodelab.com/v1/rulings全文检索 CBP CROSS 海关裁定
POSTapi.hscodelab.com/v1/classify/bulk单次调用最多归类 1,000 个商品
GETapi.hscodelab.com/v1/policies获取最新的 301 / TARIC / CBAM 政策变动
响应格式
结构化、强类型、可预测。
所有响应均为 camelCase JSON,结构稳定。Section 301、T86、CBAM、反倾销与原产地标识等合规标志均以枚举常量返回,绝不使用自由文本。
OpenAPI 3.1 规范,自动生成 TypeScript 类型
所有 POST 接口支持幂等性键
编码相关政策变动通过 Webhook 推送
SOC 2 Type II · GDPR · 数据保留 30 天
200 OK · application/json~340ms
{
"request_id": "req_4f9a3b21c0d8",
"candidates": [
{
"code": "8518.30.20",
"confidence": 0.96,
"description": "Headphones and earphones, with or without microphone",
"tariffs": {
"us": { "base": 0.049, "section_301": 0.25 },
"eu": { "base": 0.0, "vat": 0.20 }
},
"cross_rulings": ["N324581"]
}
],
"flags": ["section_301_list_3", "t86_eligible"]
}