Korea Trade Statistics API - Import Export by HS Code 수출입실적

Korea Trade Statistics API: Import & Export by HS Code (수출입실적)

Get official South Korean import and export statistics by HS code and partner country as clean JSON / CSV / Excel. Every row is a monthly figure from the Korea Customs Service (관세청) trade statistics: export value in USD, import value in USD, weight in kg and trade balance, for any product from 2-digit HS chapters down to 10-digit Korean HSK lines.

Ask for 8542 (integrated circuits) with US and CN and get the monthly breakdown by 6-digit sub-heading for each country. Field names are in English, with the official Korean product description and country name kept next to them. No Korean, no data.go.kr account and no API key needed.

What you can use it for

• Market research and sizing: how much of a product Korea exports to or imports from a country, month by month.
• Supply chain and sourcing: find which HS lines Korea buys from China, Vietnam or the US, and how the volume changes.
• Investment and macro research: track semiconductors, batteries, cars, ships or cosmetics exports, the indicators analysts watch first.
• Trade compliance and tariff work: HS-level values and weights for a specific partner, ready for spreadsheets or BI tools.
• Data pipelines and AI agents: a consistent English schema you can schedule monthly.

Input

Field	Example	Notes
hsCodes	["8542", "8703"]	2, 4, 6 or 10 digits. Results come one level deeper: 2 -> 4-digit headings, 4 -> 6-digit sub-headings, 6 -> 10-digit HSK lines, 10 -> that line. Empty = all products (then give a country).
products	["semiconductors", "cosmetics"]	Optional plain-English names mapped to HS codes (list below).
countries	["US", "Vietnam"]	ISO 2-letter codes or English names. Empty = all partner countries.
startMonth / endMonth	2025-01 / 2025-12	Empty = the latest 12 published months. Longer ranges are split into 12-month requests automatically.
includeTotals	true	Adds one row_type: "total" row per request with summed values for the period.
onlyNonZero	true	Skips detail rows where export and import are both 0.
maxItems	10000	Stop after N rows. 0 = no limit.

Example: Korean chip trade with the US and China over the last year

{ "hsCodes": ["8542"], "countries": ["US", "CN"] }

Example: Korean cosmetics exports to every country in 2025

{ "hsCodes": ["3304"], "startMonth": "2025-01", "endMonth": "2025-12" }

Example: everything Korea traded with Vietnam in one month, at 10-digit detail

{ "countries": ["VN"], "startMonth": "2026-06", "endMonth": "2026-06", "maxItems": 0 }

Product names accepted in products: semiconductors, chips, memory chips, processors, cars, auto parts, electric vehicles, batteries, lithium-ion batteries, smartphones, displays, ships, steel, crude oil, petroleum products, lng, cosmetics, skincare, ramen, kimchi, soju, beer, beef, pork, coffee, wine, seaweed, ginseng, tires, plastics, pharmaceuticals, vaccines, computers, solar panels, machinery, medical devices, toys, apparel, furniture.

Output example

{
  "row_type": "detail",
  "month": "2025-10",
  "query_hs_code": "8542",
  "query_country": "US",
  "hs_code": "854231",
  "hs_digits": 6,
  "hs_chapter": "85",
  "hs_chapter_name_en": "Electrical machinery, electronics, semiconductors",
  "product_name_ko": "프로세서와 컨트롤러[메모리ㆍ변환기ㆍ논리회로ㆍ증폭기ㆍ클록(clock)ㆍ타이밍(timing) 회로나 그 밖의 회로를 갖춘 것인지는 상관없다]",
  "country_code": "US",
  "country_name_en": "United States",
  "country_name_ko": "미국",
  "export_value_usd": 43322718,
  "export_weight_kg": 15746,
  "import_value_usd": 108979795,
  "import_weight_kg": 11427,
  "trade_balance_usd": -65657077,
  "source": "Korea Customs Service (관세청) trade statistics via data.go.kr, license: 이용허락범위 제한 없음"
}

Total row for the same request (October 2025 to September 2026): exports $2,844,551,167, imports $2,066,607,242, balance $777,943,925.

Pricing

Pay per result:

• $1.50 per 1,000 rows (detail or total rows)

A year of one 4-digit HS code with one country is typically 20 to 120 rows, so a few cents. You can set a maximum cost per run in Apify and the actor stops when it is reached.

FAQ

How fresh is the data? Korea Customs publishes monthly figures with a delay of about one to two months. By default the actor asks for the 12 months ending two months ago; set endMonth to try a more recent month.

What is the difference between HS and HSK? The first 6 digits are the international Harmonized System. Korea adds 4 more digits (HSK) for national detail, so 10-digit codes are Korea-specific.

Is "export" from Korea's point of view? Yes. export_value_usd is what Korea shipped to the partner country and import_value_usd is what Korea bought from it. Values are in US dollars, weights in kilograms.

Can I get English product names? The official descriptions are Korean only. Each row carries the English HS chapter name, and the HS code itself is international, so you can join it to any English HS nomenclature.

How far back can I go? Several years of monthly history are available. Ranges longer than 12 months are split into yearly requests automatically.

Why is my request rejected? Give at least one HS code or one country. Without either the request would be every product with every country.

Source and license

• Korea Customs Service (관세청): 품목별 국가별 수출입실적(GW), via the Public Data Portal (공공데이터포털, data.go.kr, https://www.data.go.kr/data/15100475/openapi.do). License: 이용허락범위 제한 없음 (no restriction on use).

Every result carries a source field naming the origin. This actor is not affiliated with the Korean government.