The Korea Trade & HS Code API delivers comprehensive Korean import and export statistics from the Korea Customs Service, enriched with a complete HS code master database in both Korean and English.
What makes this API unique is the combination of two powerful data sources. First, real-time monthly trade statistics from the Korean government, including export amounts, import amounts, weight in kilograms, and trade balance for any HS code and partner country. Second, a curated HS code master containing 12,469 codes with both Korean and English item names, weight units, classification categories, and validity periods. This bilingual mapping is essential for global users since the official Korean government API provides Korean names only.
The main endpoint accepts an HS code (2, 4, 6, or 10 digits), a date range in YYYYMM format, and an optional ISO country code, then returns a clean JSON response containing the HS code metadata, monthly trade records, and aggregate summary statistics. We automatically separate the official total row from monthly records to prevent double-counting in your analytics.
Additional endpoints let you look up any HS code instantly, search by Korean or English keywords (with auto-language detection), or browse codes by prefix to explore product categories.
Typical use cases include market intelligence platforms tracking Korean trade flows, e-commerce companies analyzing import demand for specific product categories, supply chain analysts monitoring shipment volumes, financial researchers studying bilateral trade trends, and customs brokerage software needing reliable HS code translations. The API returns clean, normalized JSON that integrates easily with spreadsheets, dashboards, machine learning pipelines, and BI tools.
{"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'
{"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'
{"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'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
The "Get Trade Statistics by HS Code" endpoint returns monthly trade statistics, including export/import amounts in USD, weights in kilograms, and HS code metadata. The "Lookup HS Code Details" endpoint provides full HS code metadata, while the "Search HS Codes by Keyword or Prefix" endpoint returns matching HS codes with bilingual names and metadata.
Key fields include HS code, item names in Korean and English, weight unit, export/import codes, trade amounts, weights, and trade balance. For trade statistics, fields like year_month, total_export_usd, and total_import_kg are also included.
The main endpoint accepts HS code (2, 4, 6, or 10 digits), a date range in YYYYMM format, and an optional ISO country code. The search endpoint allows keyword input in Korean or English and accepts a code prefix for category exploration.
The response is structured in JSON format, with a top-level object containing query parameters, HS code information, trade data as an array, and a summary section for aggregate statistics. This organization facilitates easy data extraction and analysis.
The data is sourced from the Korea Customs Service, ensuring it reflects real-time monthly trade statistics. The HS code master is curated to provide accurate bilingual translations, enhancing usability for global users.
Typical use cases include market intelligence platforms tracking trade flows, e-commerce companies analyzing import demand, supply chain analysts monitoring shipment volumes, and customs brokerage software needing reliable HS code translations.
Users can customize requests by specifying HS codes, date ranges, and country codes for trade statistics. For HS code searches, they can use keywords in either language or specify prefixes to explore related product categories.
Users can integrate the clean, normalized JSON data into spreadsheets, dashboards, or BI tools for analysis. The structured response allows for easy extraction of specific fields, enabling detailed reporting and insights into trade patterns.
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
Service Level:
100%
Response Time:
0ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
223ms
Service Level:
100%
Response Time:
264ms
Service Level:
100%
Response Time:
223ms