Korea HS Code Classification API

Turn natural-language product names (Korean · Japanese · English) into Korea HS code candidates with tariff rates for Korea and 14 FTA/RCEP partners. Semantic search over the official Korea Customs tariff table.

原始信息汇总

数据集概述：Korea HS Code Classification API

该API是一个用于将自然语言产品名称（支持韩语、日语和英语）转换为韩国HS编码候选列表的工具，并提供相应的关税税率信息。它基于韩国海关总署的官方关税表构建，覆盖11,326个税目。

核心功能

• HS编码分类：输入产品名称（如“나이키 운동화”、“wireless earbuds”、“革の財布”），API返回最多5个韩国HS编码候选，并按匹配分数排序。
• 关税税率查询：每个候选编码附带关税税率，包括韩国基础税率、WTO税率，以及针对14个FTA/RCEP伙伴国家的优惠税率。
• 直接编码查询：也可直接输入4–10位数字的HS编码，跳过分类步骤，仅获取该编码对应的关税税率。

关键特性

• 韩语/日语优化：分类质量针对韩语和日语产品名称专门调优，弥补了多数全球HS API在这方面的空白。
• 官方数据源：基于韩国海关总署的关税表构建，为KOGL Type 1开放数据。
• 诚实的准确性：在标注评估集上的表现为top-1准确率64%、top-5召回率93%。API返回的是带有分数的有序候选列表，而非单一的“猜测”答案。

技术详情

• 端点：GET /api/v1/classify
• 请求参数：
  • q（必填）：自然语言产品名称，或4–10位HS编码，最大200字符。
  • lang（可选）：查询解释语言，ko（默认）、ja、en。
  • countries（可选）：逗号分隔的国家/地区代码。kr为基础+WTO税率；FTA伙伴包括：us, eu, cn, gb, vn, jp, asean, au, ca, in, sg, tr, nz, cl。默认仅kr。
  • limit（可选）：返回候选数，范围1–5，默认5。
• 响应内容：包含hs_code、韩语/日语名称、分数，以及各国家/地区的税率。

目标用户

适用于跨境电商卖家、货运代理和报关行工具、市场平台和物流平台，用于添加HS编码建议或计算落地成本（landed cost）等功能。

重要声明

该API提供的信息仅供参考，不具有法律效力。最终的HS分类由海关当局确定。在实际申报或支付前，务必与韩国海关或持牌报关行确认。