韩国贸易与HS编码API提供来自韩国海关的全面进口和出口统计数据,并配有完整的韩文和英文HS编码主数据库
该API的独特之处在于它结合了两个强大的数据源首先,来自韩国政府的实时月度贸易统计,包括任何HS编码和伙伴国的出口金额、进口金额、重量(以千克为单位)和贸易余额其次,精心策划的HS编码主数据库包含12,469个编码,具有韩文和英文商品名称、重量单位、分类类别和有效期这种双语映射对于全球用户至关重要,因为官方的韩国政府API仅提供韩文名称
主要接口接受HS编码(2、4、6或10位数字)、以YYYYMM格式的日期范围和可选的ISO国家代码,然后返回一个干净的JSON响应,其中包含HS编码元数据、每月贸易记录和汇总统计数据我们自动将官方总行与每月记录分开,以防止在您的分析中重复计算
附加端点允许您立即查找任何HS编码,通过韩文或英文关键词(自动语言检测)进行搜索,或按前缀浏览编码以探索产品类别
典型的使用案例包括跟踪韩国贸易流的市场情报平台、分析特定产品类别进口需求的电子商务公司、监控运输量的供应链分析师、研究双边贸易趋势的金融研究人员,以及需要可靠HS编码翻译的海关代理软件该API返回干净、标准化的JSON,易于与电子表格、仪表板、机器学习管道和BI工具集成
按HS编码获取贸易统计 - 端点功能
| 对象 | 描述 |
|---|---|
start_month |
[必需] Start month in YYYYMM format (e.g., 202501 for January 2025). Used together with end_month, maximum 1-year range allowed. |
end_month |
[必需] End month in YYYYMM format (e.g., 202512). Must be within 12 months of start_month. |
country |
可选 (Optional) ISO 3166-1 alpha-2 country code of the trade partner (e.g., US, JP, CN, DE). If omitted, returns trade data for ALL countries. |
hs_code |
[必需] Harmonized System (HS) code identifying the product. Accepts 2, 4, 6, or 10-digit codes (e.g., 1001 for wheat, 8517 for telephones). |
{"query":{"hs_code":"1001999090","start_month":"202401","end_month":"202403","country":"US"},"hs_info":{"code":"1001999090","name_ko":"기타","name_en":"Other","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11101","category_name":"(밀)","valid_from":"2012-01-01","valid_to":"2026-12-31"},"trade_data":[{"year_month":"2024.01","hs_code":"1001999090","country_code":"US","export_amount_usd":0,"export_weight_kg":0,"import_amount_usd":63506,"import_weight_kg":175479,"trade_balance_usd":-63506},{"year_month":"2024.02","hs_code":"1001999090","country_code":"US","export_amount_usd":0,"export_weight_kg":0,"import_amount_usd":40211,"import_weight_kg":20011,"trade_balance_usd":-40211},{"year_month":"2024.03","hs_code":"1001999090","country_code":"US","export_amount_usd":0,"export_weight_kg":0,"import_amount_usd":344275,"import_weight_kg":1096710,"trade_balance_usd":-344275}],"summary":{"total_export_usd":0,"total_import_usd":447992,"total_export_kg":0,"total_import_kg":1292200,"trade_balance_usd":-447992,"months_covered":3},"record_count":3}
curl --location --request GET 'https://zylalabs.com/api/12466/korea+trade+and+hs+code+api/23643/get+trade+statistics+by+hs+code?start_month=202501&end_month=202512&country=US&hs_code=1001' --header 'Authorization: Bearer YOUR_API_KEY'
返回完整的HS编码元数据,包括韩文和英文商品名称、重量单位、分类类别、出口和进口代码及有效日期。接受任何2位、4位、6位或10位的HS编码
{"code":"1001999090","name_ko":"기타","name_en":"Other","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11101","category_name":"(밀)","valid_from":"2012-01-01","valid_to":"2026-12-31"}
curl --location --request GET 'https://zylalabs.com/api/12466/korea+trade+and+hs+code+api/23644/lookup+hs+code+details&CODE=Required' --header 'Authorization: Bearer YOUR_API_KEY'
通过关键词(自动检测韩文或英文)或代码前缀搜索HS编码,以探索产品类别。返回匹配的编码及其双语名称和元数据
{"query":{"keyword":"wheat","prefix":null,"lang":"auto"},"results":[{"code":"1008100000","name_ko":"메밀","name_en":"Buckwheat","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11501","category_name":"(밀)","valid_from":"2002-01-01","valid_to":"2026-12-31"},{"code":"1101001000","name_ko":"밀가루","name_en":"Of wheat","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11501","category_name":"(밀가루)","valid_from":"2002-01-01","valid_to":"2026-12-31"},{"code":"1103110000","name_ko":"밀로 만든 것","name_en":"Of wheat","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11501","category_name":"(밀가루)","valid_from":"2013-01-01","valid_to":"2026-12-31"},{"code":"1103201000","name_ko":"밀로 만든 것","name_en":"Of wheat","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11501","category_name":"(밀가루)","valid_from":"2013-01-01","valid_to":"2026-12-31"},{"code":"1108110000","name_ko":"밀로 만든 것","name_en":"Wheat starch","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"26J01","category_name":"(밀가루)","valid_from":"2013-01-01","valid_to":"2026-12-31"},{"code":"1109000000","name_ko":"밀의 글루텐(gluten)(건조했는지에 상관없다)","name_en":"Wheat gluten, whether or not dried.","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"26J01","category_name":"(기타 제분 생산품)","valid_from":"2013-01-01","valid_to":"2026-12-31"},{"code":"1904300000","name_ko":"불거 밀(bulgur wheat)","name_en":"Bulgur wheat","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"12313","category_name":"(곡물 가공품)","valid_from":"2013-01-01","valid_to":"2026-12-31"},{"code":"2302300000","name_ko":"밀에서 나온 것","name_en":"Of wheat","weight_unit":"KG","qty_unit":null,"export_code":"11Z01","import_code":"11402","category_name":"(농산물 부산물)","valid_from":"2013-01-01","valid_to":"2026-12-31"}],"count":8}
curl --location --request GET 'https://zylalabs.com/api/12466/korea+trade+and+hs+code+api/23645/search+hs+codes+by+keyword+or+prefix&KEYWORD=Required' --header 'Authorization: Bearer YOUR_API_KEY'
此端点不需要任何输入参数。
测试端点
{"name":"Korea Trade & HS Code API","version":"1.0.0","hs_codes_loaded":12469,"endpoints":{"/trade/search":"Main trade query (HS code + country)","/hs/lookup":"Single HS code lookup","/hs/search":"Search HS codes by keyword/prefix"}}
curl --location --request GET 'https://zylalabs.com/api/12466/korea+trade+and+hs+code+api/23646/get+api+info' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
“按HS编码获取贸易统计”接口返回每月贸易统计数据,包括以美元计的出口/进口金额、以千克计的重量以及HS编码元数据。“查询HS编码详细信息”接口提供完整的HS编码元数据,而“按关键词或前缀搜索HS编码”接口返回匹配的HS编码及其双语名称和元数据
关键字段包括海关编码、韩文和英文的商品名称、重量单位、进出口编码、贸易金额、重量和贸易余额。对于贸易统计,字段如年_月、总出口美元和总进口千克也包含在内
主要端点接受HS编码(2、4、6或10位)、YYYYMM格式的日期范围以及可选的ISO国家代码 搜索端点允许以韩语或英语输入关键词,并接受用于类别探索的代码前缀
响应采用JSON格式结构,顶层对象包含查询参数、HS编码信息、作为数组的贸易数据以及用于汇总统计的总结部分。这种组织方式便于数据提取和分析
数据来源于韩国海关,确保反映实时的月度贸易统计。HS编码主表经过精心整理,提供准确的双语翻译,提高全球用户的可用性
典型的使用案例包括跟踪贸易流的市场情报平台 电子商务公司分析进口需求 供应链分析师监测发货量 以及需要可靠的HS编码翻译的报关软件
用户可以通过指定HS编码、日期范围和国家代码来自定义贸易统计请求。对于HS编码搜索,他们可以使用任意语言的关键词或指定前缀以探索相关产品类别
用户可以将干净、标准化的 JSON 数据集成到电子表格、仪表板或商业智能工具中进行分析 结构化的响应可以轻松提取特定字段,从而 enables对交易模式的详细报告和洞察
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
977ms
服务级别:
100%
响应时间:
264ms
服务级别:
100%
响应时间:
223ms
服务级别:
100%
响应时间:
223ms
服务级别:
100%
响应时间:
960ms
服务级别:
100%
响应时间:
937ms
服务级别:
100%
响应时间:
1,245ms
服务级别:
100%
响应时间:
944ms
服务级别:
100%
响应时间:
223ms