tariff-rate

This is an API to find the duty rates / tariff.

原始信息汇总

tariff-rate API 数据集概述

基本信息

• 数据集名称: tariff-rate (HTS Tariff Code Lookup API)
• 提供者: PineappleLLC
• 类别: Commerce
• API版本: 1.0.0 (current)
• 基础计划价格: $0.00 / 月
• 专业计划价格: $10.00 / 月
• 高级计划价格: $50.00 / 月
• 服务等级: 38%
• 延迟: 952ms
• 测试通过率: 86%
• 订阅者数量: 1

核心功能描述

这是一个面向开发者的海关分类和关税税率查询API，覆盖**美国（HTS）和欧盟（TARIC）**市场。旨在通过单次API调用获取关税编码和进口关税税率。

主要特性

• 语义搜索：使用纯英文描述产品，即可获取匹配的HS编码及其关税税率。自动检测查询内容是产品描述还是HS编码。
• 包含关税税率：每个搜索结果都包含基于您指定的原产国适用的关税税率，无需单独进行税率查询。
• 美国+欧盟覆盖：使用同一API查询美国HTS编码或欧盟TARIC编码，只需更改country参数。
• 完整层级浏览：浏览完整的海关分类树：节（sections）→ 章（chapters）→ 目（headings）→ 子目（subheadings）。可向下钻取或将任何编码解析为其完整路径及同级上下文。
• 原产地感知：关税税率因货物原产地而异。指定原产国即可获取正确的税率，而非通用的最惠国（MFN）备用税率。

适用场景

• 为跨境电子商务计算到岸成本
• 在运输软件中实现海关分类自动化
• 为贸易合规团队构建关税查询工具
• 利用实时关税税率数据支持产品采购决策

技术规格

端点

端点	配额类别	描述
GET /api/hts/search	Search	通过描述或HS编码搜索，返回关税税率
GET /api/hts/codes	Browse Hierarchy	浏览海关层级结构（节、章、编码）
GET /api/hts/resolve	Browse Hierarchy	将任何HS编码解析为其完整的分类路径

所有端点调用均计入内置的请求（Requests）配额。

支持的市场

市场	数据源	覆盖范围
US	HTS (Harmonized Tariff Schedule)	完整的10位分类编码 + 关税税率
EU	TARIC (Integrated Tariff of the EU)	完整的分类编码 + 关税税率

默认市场为美国。传递 destination=EU（或任何欧盟成员国代码，如FR、DE）以获取欧盟/TARIC数据。EU 被接受为有效的目的地值。

参数参考

搜索端点 (/api/hts/search)

参数	必填	默认值	描述
q	是	—	产品描述或HS编码
origin	是	—	原产国（ISO 3166-1 alpha-2，例如 EC, CN, TN）
destination	否	US	目的地市场（US, EU，或任何欧盟成员国代码如 FR, DE）
limit	否	1	返回的结果数量（1-5）

浏览端点 (/api/hts/codes)

参数	必填	默认值	描述
destination	否	US	目的地市场（US, EU，或任何欧盟成员国代码如 FR, DE）
section	否	—	节ID（1-22）以列出章
parentCode	否	—	父编码以展开其子项

注意：section 和 parentCode 是互斥的——传递其中一个或不传，不能同时传递。

解析端点 (/api/hts/resolve)

参数	必填	默认值	描述
hsCode	是	—	要解析的HS编码（例如 0803.90）
destination	否	US	目的地市场（US, EU，或任何欧盟成员国代码如 FR, DE）

税率字段

每个搜索结果包含两个税率字段：

• rate (字符串) — 人类可读的关税税率。当该编码/原产国对没有可用税率数据时为空字符串。
• numericRate (数字或 null) — 总关税百分比，或当税率无法表示为单一百分比（特定、复合或条件关税）时为 null。

可能的 rate 格式

格式	示例	适用情况
零关税	"0%"	免税商品（美国 & 欧盟）
百分比	"16%", "5.5%"	从价税（美国 & 欧盟）
特定关税	"30.9 €/DTN"	单位关税（欧盟）
复合关税	"10.2% + 93.1 €/DTN"	从价税 + 特定关税（欧盟）
条件关税	"Cond: ..."	欧盟条件税率
文本注释	"See Additional Note"	带有脚注的复杂税率（美国）
空值	""	该编码/原产国对没有可用的税率数据

税率已为可读性进行了标准化处理（例如，去除尾随零，使用 € 而非 EUR）。请将 rate 视为显示字符串，而非数字——当需要进行算术运算时，请使用 numericRate。

错误代码

状态码	适用端点	含义
400	所有	参数无效（缺少必填字段、国家代码错误、限制超出范围）
401	所有	API密钥缺失或无效
404	仅搜索	未找到与搜索查询匹配的编码
429	所有	信用额度超出——升级您的计划（由RapidAPI网关返回）
502	解析、搜索	上游关税服务暂时不可用
503	所有	服务未为请求的市场配置

常见问题解答

• 接受的HS编码格式：数字、点和空格：0803、0803.90、0803 90 19 00 均可。
• 搜索端点的自动检测工作原理：如果查询包含4位或更多数字，且仅包含数字/点/空格/连字符，则被视为HS编码查询。否则视为文本搜索。
• 搜索中为何需要 origin 参数：关税税率因货物原产地而异。没有原产地信息，API无法返回有意义的税率（例如，欧盟→欧盟始终为0%，这没有用处）。
• 如何获取多个原产国的税率：使用不同的 origin 值进行单独的搜索调用。

联系信息

如有问题、疑问或合作咨询，请联系：[e-mail]

提供者信息

• API创建者: PineappleLLC
• 产品网站: https://rapidapi.com/pineapplellc1-pineapplellc-default/api/tariff-rate (页面地址)

搜集汇总

背景与挑战

背景概述

该数据集提供了一个API接口，专门用于查询关税税率信息。它作为一个工具，帮助用户获取相关的关税数据。