{"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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Investigação de Importação de Comércio Eletrônico Comércio da Coreia e Código HS API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
A API de Comércio da Coreia e Código HS oferece estatísticas completas de importação e exportação da Coreia do Serviço de Alfândega da Coreia, enriquecidas com uma base de dados mestre de códigos HS completa em coreano e inglês
O que torna essa API única é a combinação de duas poderosas fontes de dados Primeiro, estatísticas comerciais mensais em tempo real do governo coreano, que incluem quantidades de exportação, quantidades de importação, peso em quilogramas e saldo comercial para qualquer código HS e país parceiro Segundo, um mestre de códigos HS curado que contém 12.469 códigos com nomes de itens em coreano e inglês, unidades de peso, categorias de classificação e períodos de validade Este mapeamento bilíngue é essencial para os usuários globais, pois a API oficial do governo coreano fornece nomes apenas em coreano
O ponto final principal aceita um código HS (2, 4, 6 ou 10 dígitos), um intervalo de datas no formato AAAAMM e um código de país ISO opcional, e então retorna uma resposta JSON limpa que contém os metadados do código HS, registros comerciais mensais e estatísticas resumo agregadas Separar automaticamente a linha total oficial dos registros mensais para prevenir a contagem dupla em sua análise
Pontos finais adicionais permitem que você busque qualquer código HS instantaneamente, procure por palavras-chave em coreano ou inglês (com detecção automática de idioma), ou navegue por códigos por prefixo para explorar categorias de produtos
Os casos de uso típicos incluem plataformas de inteligência de mercado que rastreiam os fluxos comerciais da Coreia, empresas de comércio eletrônico que analisam a demanda de importação para categorias de produtos específicas, analistas da cadeia de suprimentos que monitoram os volumes de envio, pesquisadores financeiros que estudam tendências comerciais bilaterais e software de corretagem aduaneira que precisa de traduções confiáveis de códigos HS A API retorna JSON limpo e normalizado que se integra facilmente com planilhas, painéis, pipelines de aprendizado de máquina e ferramentas de BI
O endpoint "Obter Estatísticas Comerciais por Código HS" retorna estatísticas comerciais mensais, incluindo valores de exportação/importação em USD, pesos em quilogramas e metadados do código HS O endpoint "Pesquisar Detalhes do Código HS" fornece metadados completos do código HS, enquanto o endpoint "Buscar Códigos HS por Palavra-chave ou Prefixo" retorna códigos HS correspondentes com nomes bilíngues e metadados
Os campos chave incluem o código HS nomes de itens em coreano e inglês unidade de peso códigos de exportação/importação quantidades comerciais pesos e saldo comercial Para as estatísticas comerciais também são incluídos campos como ano_mês total_export_usd e total_import_kg
O endpoint principal aceita código HS (2, 4, 6 ou 10 dígitos), um intervalo de datas no formato AAAAMM e um código de país ISO opcional O endpoint de busca permite a entrada de palavras-chave em coreano ou inglês e aceita um prefixo de código para exploração de categorias
A resposta está estruturada em formato JSON com um objeto de nível superior que contém parâmetros de consulta informações do código HS dados comerciais como um array e uma seção de resumo para estatísticas agregadas Esta organização facilita a extração e a análise de dados
Os dados são obtidos do Serviço de Alfândega da Coreia, garantindo que reflitam estatísticas comerciais mensais em tempo real. O master do código HS é elaborado para fornecer traduções bilíngues precisas, melhorando a usabilidade para usuários globais
Os casos de uso típicos incluem plataformas de inteligência de mercado que rastreiam fluxos comerciais empresas de comércio eletrônico que analisam a demanda de importação analistas da cadeia de suprimentos que monitoram os volumes de envio e software de corretagem de aduanas que precisam de traduções confiáveis de códigos HS
Os usuários podem personalizar solicitações especificando códigos HS, intervalos de datas e códigos de países para estatísticas de comércio. Para buscas de código HS, podem usar palavras-chave em qualquer um dos idiomas ou especificar prefixos para explorar categorias de produtos relacionadas
Os usuários podem integrar os dados JSON limpos e normalizados em planilhas painéis de controle ou ferramentas de BI para análise A resposta estruturada permite uma fácil extração de campos específicos o que permite relatórios detalhados e análise de padrões comerciais