{"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/12475/e+commerce+import+research+korea+trade+and+hs+code+api/23694/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/12475/e+commerce+import+research+korea+trade+and+hs+code+api/23695/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/12475/e+commerce+import+research+korea+trade+and+hs+code+api/23696/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/12475/e+commerce+import+research+korea+trade+and+hs+code+api/23697/get+api+info' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Investigación de Importación de Comercio Electrónico Comercio de Corea y Código HS API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
La API de Comercio de Corea y Código HS ofrece estadísticas completas de importación y exportación de Corea del Servicio de Aduanas de Corea, enriquecidas con una base de datos maestra de códigos HS completa en coreano e inglés.
Lo que hace que esta API sea única es la combinación de dos poderosas fuentes de datos. Primero, estadísticas comerciales mensuales en tiempo real del gobierno coreano, que incluyen cantidades de exportación, cantidades de importación, peso en kilogramos y saldo comercial para cualquier código HS y país socio. Segundo, un maestro de códigos HS curado que contiene 12,469 códigos con nombres de artículos en coreano e inglés, unidades de peso, categorías de clasificación y períodos de validez. Este mapeo bilingüe es esencial para los usuarios globales ya que la API oficial del gobierno coreano proporciona nombres solo en coreano.
El punto final principal acepta un código HS (2, 4, 6 o 10 dígitos), un rango de fechas en formato AAAAMM y un código de país ISO opcional, y luego devuelve una respuesta JSON limpia que contiene los metadatos del código HS, registros comerciales mensuales y estadísticas resumen agregadas. Separamos automáticamente la fila total oficial de los registros mensuales para prevenir el conteo doble en su análisis.
Puntos finales adicionales le permiten buscar cualquier código HS al instante, buscar por palabras clave en coreano o inglés (con detección automática de idioma), o navegar por códigos por prefijo para explorar categorías de productos.
Los casos de uso típicos incluyen plataformas de inteligencia de mercado que rastrean los flujos comerciales de Corea, empresas de comercio electrónico que analizan la demanda de importación para categorías de productos específicas, analistas de la cadena de suministro que monitorean los volúmenes de envío, investigadores financieros que estudian tendencias comerciales bilaterales y software de corretaje aduanero que necesita traducciones confiables de códigos HS. La API devuelve JSON limpio y normalizado que se integra fácilmente con hojas de cálculo, tableros, pipelines de aprendizaje automático y herramientas de BI.
El endpoint "Obtener estadísticas comerciales por código HS" devuelve estadísticas comerciales mensuales que incluyen montos de exportación/importación en USD, pesos en kilogramos y metadatos del código HS. El endpoint "Buscar detalles del código HS" proporciona metadatos completos del código HS, mientras que el endpoint "Buscar códigos HS por palabra clave o prefijo" devuelve códigos HS coincidentes con nombres y metadatos bilingües
Los campos clave incluyen el código HS, nombres de artículos en coreano e inglés, unidad de peso, códigos de exportación/importación, cantidades comerciales, pesos y saldo comercial. Para las estadísticas comerciales, también se incluyen campos como año_mes, total_export_usd y total_import_kg
El punto final principal acepta código HS (2, 4, 6 o 10 dígitos) un rango de fechas en formato AAAAMM y un código de país ISO opcional El punto final de búsqueda permite la entrada de palabras clave en coreano o inglés y acepta un prefijo de código para la exploración de categorías
La respuesta está estructurada en formato JSON con un objeto de nivel superior que contiene parámetros de consulta información del código HS datos comerciales como un arreglo y una sección de resumen para estadísticas agregadas Esta organización facilita la extracción y el análisis de datos
Los datos provienen del Servicio de Aduanas de Corea, lo que garantiza que reflejan estadísticas comerciales mensuales en tiempo real. El maestro de códigos HS está curado para proporcionar traducciones bilingües precisas, mejorando la usabilidad para los usuarios globales
Los casos de uso típicos incluyen plataformas de inteligencia de mercado que rastrean flujos comerciales empresas de comercio electrónico que analizan la demanda de importación analistas de la cadena de suministro que monitorean los volúmenes de envío y software de corretaje de aduanas que necesita traducciones confiables de códigos HS
Los usuarios pueden personalizar las solicitudes especificando códigos HS, rangos de fechas y códigos de país para las estadísticas comerciales. Para las búsquedas de códigos HS pueden utilizar palabras clave en cualquiera de los dos idiomas o especificar prefijos para explorar categorías de productos relacionadas
Los usuarios pueden integrar los datos JSON limpios y normalizados en hojas de cálculo, paneles de control o herramientas de BI para análisis La respuesta estructurada permite una fácil extracción de campos específicos lo que permite informes detallados y análisis de patrones comerciales