A API de Comércio da Coreia e HS Código fornece dados abrangentes de estatísticas de importação e exportação da Alfândega da Coreia, acompanhados de um banco de dados principal de códigos HS completo em coreano e inglês.
A singularidade desta API está em sua combinação de duas poderosas fontes de dados. Primeiro, estatísticas comerciais mensais em tempo real do governo coreano, incluindo valores de exportação e importação de qualquer código HS e países parceiros, peso (em quilogramas) e saldo comercial. Em segundo lugar, o meticulosamente elaborado banco de dados principal de códigos HS contém 12.469 códigos, com nomes de produtos em coreano e inglês, unidades de peso, categorias de classificação e validade. Essa mapeação bilíngue é crucial para usuários globais, pois a API oficial do governo coreano fornece apenas nomes em coreano.
A interface principal aceita códigos HS (2, 4, 6 ou 10 dígitos), um intervalo de datas no formato YYYYMM e um código de país ISO opcional, e então retorna uma resposta JSON limpa, que contém metadados de códigos HS, registros de comércio mensal e estatísticas resumidas. Nós automaticamente separamos o total oficial de cada mês dos registros mensais para evitar contagem dupla em sua análise.
Endpoints adicionais permitem que você encontre imediatamente qualquer código HS, buscando por palavras-chave em coreano ou inglês (detecção automática de idioma), ou navegando os códigos por prefixo para explorar categorias de produtos.
Casos de uso típicos incluem plataformas de inteligência de mercado que rastreiam fluxos de comércio da Coreia, empresas de e-commerce que analisam a demanda de importação em categorias de produtos específicas, analistas de cadeia de suprimentos que monitoram volumes de transporte, pesquisadores financeiros que estudam tendências de comércio bilateral, e softwares de agentes aduaneiros que precisam de traduções de códigos HS confiáveis. A API retorna JSON limpo e padronizado, fácil de integrar com planilhas, painéis, pipelines de aprendizado de máquina e ferramentas de BI.
Retorna estatísticas de comércio da Coreia (valores de exportação e importação em USD, pesos em quilogramas, detalhamento mensal) para qualquer código HS e país parceiro, além de metadados enriquecidos do código HS com nomes de itens em coreano e inglês
Obtenha Estatísticas de Comércio por Código HS - Recursos do endpoint
| Objeto | Descrição |
|---|---|
start_month |
[Obrigatório] Start month in YYYYMM format (e.g., 202501 for January 2025). Used together with end_month, maximum 1-year range allowed. |
end_month |
[Obrigatório] End month in YYYYMM format (e.g., 202512). Must be within 12 months of start_month. |
country |
Opcional (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 |
[Obrigatório] 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'
Retorna todos os metadados do código HS, incluindo nomes de itens em coreano e inglês, unidade de peso, categoria de classificação, códigos de exportação e importação, e datas de validade. Aceita qualquer código HS de 2, 4, 6 ou 10 dígitos
{"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'
Pesquise códigos HS por palavra-chave (coreano ou inglês com detecção automática) ou por prefixo de código para explorar categorias de produtos. Retorna códigos correspondentes com nomes bilíngues e metadados
{"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'
Retorna os metadados da API incluindo versão, total de códigos HS carregados na memória e uma lista de endpoints disponíveis. Útil como um verificador de saúde ou para descoberta de serviços
Este endpoint não requer parâmetros de entrada.
Testar endpoint
{"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'
| 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.
O endpoint "Obter Estatísticas de Comércio por Código HS" retorna estatísticas de comércio mensais, incluindo quantidades de exportação/importação em USD, pesos em quilogramas e metadados do código HS. O endpoint "Consultar Detalhes do Código HS" fornece metadados completos do código HS, enquanto o endpoint "Pesquisar Códigos HS por Palavra-chave ou Prefixo" retorna códigos HS correspondentes com nomes bilíngues e metadados
Os campos principais incluem código HS, nomes dos itens em coreano e inglês, unidade de peso, códigos de exportação/importação, valores comerciais, pesos e saldo comercial. Para estatísticas de comércio, campos como ano_mês, total_export_usd e total_import_kg também estão incluídos
O endpoint principal aceita código HS (2, 4, 6 ou 10 dígitos), uma faixa 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 é estruturada no formato JSON com um objeto de nível superior contendo 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 Essa organização facilita a extração e análise de dados
Os dados são provenientes do Serviço de Alfândega da Coreia, garantindo que reflitam as estatísticas de comércio mensal em tempo real. O mestre de códigos HS é elaborado para fornecer traduções bilíngues precisas, melhorando a usabilidade para usuários globais
Casos de uso típicos incluem plataformas de inteligência de mercado rastreando fluxos comerciais empresas de e-commerce analisando a demanda de importação analistas de cadeia de suprimentos monitorando volumes de remessas e software de corretagem aduaneira necessitando 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ís para estatísticas de comércio. Para pesquisas de códigos HS, eles podem usar palavras-chave em qualquer idioma ou especificar prefixos para explorar categorias de produtos relacionadas
Os usuários podem integrar os dados JSON limpos e normalizados em planilhas, painéis ou ferramentas de BI para análise A resposta estruturada permite a extração fácil de campos específicos possibilitando relatórios detalhados e insights sobre os padrões comerciais
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
264ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
848ms
Nível de serviço:
100%
Tempo de resposta:
1.173ms
Nível de serviço:
100%
Tempo de resposta:
118ms
Nível de serviço:
100%
Tempo de resposta:
894ms
Nível de serviço:
100%
Tempo de resposta:
958ms
Nível de serviço:
100%
Tempo de resposta:
802ms
Nível de serviço:
80%
Tempo de resposta:
573ms
Nível de serviço:
100%
Tempo de resposta:
717ms
Nível de serviço:
100%
Tempo de resposta:
343ms
Nível de serviço:
100%
Tempo de resposta:
189ms