Landed Cost Estimator — HS Code & Import Duty Range API

Estimate what a product costs to import: 6-digit HS subheading, duty rate range, and Section 301 exposure from a plain-English description.

原始信息汇总

数据集详情总结：Landed Cost Estimator — HS Code & Import Duty Range API

核心功能

该API通过接收纯英文商品描述，提供以下关键信息：

• 6位国际HS子目录编号及对应的置信度分数
• 估计关税范围：基于该子目录下美国关税线的公布一般税率（General/Column 1）范围、最常见税率及其覆盖的关税线数量
• 第301条款风险暴露：针对中国商品，报告该子目录下的税率线是否全部或部分出现在已公布的USTR清单上，以及额外税率
• 反倾销/反补贴税（AD/CVD）及第122条款信号：如已评估则明确报告，未评估时也会明确说明，避免“空白即视为无风险”的误解
• 备选子目录：当描述存在歧义时提供多个选项，避免单一“黑箱”答案

功能边界（明确不做的事）

• 仅提供成本估算，不构成海关归类。输出上限为6位国际HS子目录，不生成8位或10位美国关税线
• 输出不得用于海关申报。如需确定关税线，属于19 U.S.C. § 1641所定义的“海关业务”，必须由持牌报关行完成
• 产品层面强制限制：任何响应字段均不会出现8位或10位代码，会产生此类代码的请求将直接失败而非返回

精度说明（透明度保障）

• 74%的子目录在所有关税线上适用单一税率，此时“范围”即为一个数字，无信息损失
• 88%的子目录税率跨度不超过5个百分点
• 3.8%的子目录跨度超过10个百分点（主要集中在鞋类和部分服装），此时响应会明确提示该区间过宽，不适合据此规划利润率，并建议咨询报关行获取具体关税线
• 响应中包含duty_estimate.precision_note字段，以简明文字说明当前估算的精度类型

端点与使用

• POST /estimate：核心预估接口
  • 必填字段：description（纯英文商品描述，最长2000字符）
  • 选填字段：country_of_origin（ISO 3166-1 alpha-2代码，最长60字符，用于驱动第301条款/反倾销信号）
• GET /health：健康检查，返回{"status":"ok"}，仅需RapidAPI密钥认证

错误处理

状态码	含义
400	缺失或无效的description、JSON格式错误或描述超2000字符
405	HTTP方法错误
404	未知路径
422	内置关税表中无匹配描述的子目录
500	内部错误

• 错误响应体格式：{"error": "可读的错误信息"}

数据来源

• 美国国际贸易委员会（USITC）统一关税表（HTS），属于美国政府公开信息
• 完整23,193条关税线已聚合为5,612个子目录
• 数据以捆绑、版本化方式内置，非每请求实时获取，保证响应速度且不依赖第三方可用性
• 每次响应均携带数据快照日期（如tariff_schedule_snapshot字段）
• 第301条款清单成员信息来源于已公布的美国第99章注释

重要声明

• 本API仅提供建议性的一般进口成本估算，不构成海关申报归类
• Aervik Labs不判定8位或10位美国关税线，也不充当报关行角色
• 实际应缴关税及申报归类必须由持牌报关行或合格的进口记录合规人员完成