{"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://pr213-testing.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://pr213-testing.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://pr213-testing.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://pr213-testing.zylalabs.com/api/12466/korea+trade+and+hs+code+api/23646/get+api+info' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Korea Trade and HS Code API simply include your bearer token in the Authorization header.
| 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.
(Save 2 months with annual billing 🎉)
Trusted by leading companies
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.
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, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key 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.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
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. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
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.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund