Korea Customs Service

Korea Customs National/Item Trade Performance (trade stats by HS item and country)

Korea Customs item-by-country trade performance (getNitemtradeList; XML source converted to JSON). Call GET /api/itemtrade directly without a key (period required and at least one of item code or country code required). The data.go.kr key is registered on the server — ready to use. Returns export/import weight and amounts (USD) and the trade balance by HS item code and country.

⚡ Item-by-country trade performance simple call

GET /api/itemtrade?strtYymm=202601&endYymm=202601&hsSgn=8542&cntyCd=US

Use this address first for item/country trade statistics. No key required, strtYymm/endYymm (YYYYMM) mandatory plus at least one of hsSgn/cntyCd. Server key registered — ready to use.

What agents get

year(YYYYMM or "total"), hsCd(HS item code), statKor(item name), statCd(country code), statCdCntnKor1(country name), expWgt(export weight kg), expDlr(export value USD), impWgt(import weight kg), impDlr(import value USD), balPayments(trade balance USD)
Look up trade volume by item and country, compare a given HS code's performance across countries

Use cases

Look up monthly export/import performance for a given HS item code
Look up item-level export/import performance for a given country
Check item-by-country export/import weight, amounts and trade balance

Registered APIs (1)

Item-by-country trade performance list getNitemtradeList

XML source converted to JSON by the simple API. strtYymm/endYymm (YYYYMM, period within one year) required. At least one of hsSgn (item code, prefix match) or cntyCd (ISO 2-letter country code) required; specifying both applies an AND filter. Response includes a final row with year="total"

strtYymm Required — Start month YYYYMM e.g. 202601
endYymm Required — End month YYYYMM (period within one year) e.g. 202601
hsSgn Optional — HS item code (prefix match, 2-10 digits). AND with cntyCd if both given e.g. 8542
cntyCd Optional — ISO 2-letter country code (e.g. US/CN/AE). AND with hsSgn if both given e.g. US
numOfRows Optional — Results per page 1-100 (default 12) e.g. 12
pageNo Optional — Page number 1-100 (default 1) e.g. 1

Returns: totalCount(total rows), items[](year/hsCd/statKor/statCd/statCdCntnKor1/expWgt/expDlr/impWgt/impDlr/balPayments)

Rate limit: 10,000 calls/day (data.go.kr developer account 10,000 calls/day)

Auth · pricing · terms

Auth	ServiceKey — data.go.kr service key. Kept only on the proxy server, never exposed to agents. Agents call only our simple API (/api/itemtrade).
Pricing	Free. Developer account auto-approved
License	Public data (per data.go.kr application terms, attribution required). No usage restrictions
Redistribution	Allowed (attribution required)
Terms checked	2026-10-16
Apply	Log in to data.go.kr -> apply for Korea Customs National/Item Trade Performance (GW) -> get a service key (developer account auto-approved) Portal
Status	Active
Last checked	2026-10-16

How agents call

Call through our proxy. Start with the keyless quick API shown above (no token needed). For the Korean law service, target=law is served from our internal law DB with no token. For the keyed proxy, send X-Agent-Token to POST /agencatalog/api/call with ('service', 'endpoint', 'params'). Token issuance is not self-service; see /agencatalog/register/. The full service list is at /agencatalog/api/services.json.

Machine-readable JSON schema

{
  "service": "customs-national-item-trade",
  "name": "Korea Customs National/Item Trade Performance (trade stats by HS item and country)",
  "provider": "Korea Customs Service",
  "apis": [
    {
      "id": "getNitemtradeList",
      "name": "Item-by-country trade performance list",
      "params": [
        {
          "name": "strtYymm",
          "required": true,
          "example": "202601",
          "desc": "Start month YYYYMM"
        },
        {
          "name": "endYymm",
          "required": true,
          "example": "202601",
          "desc": "End month YYYYMM (period within one year)"
        },
        {
          "name": "hsSgn",
          "required": false,
          "example": "8542",
          "desc": "HS item code (prefix match, 2-10 digits). AND with cntyCd if both given"
        },
        {
          "name": "cntyCd",
          "required": false,
          "example": "US",
          "desc": "ISO 2-letter country code (e.g. US/CN/AE). AND with hsSgn if both given"
        },
        {
          "name": "numOfRows",
          "required": false,
          "example": "12",
          "desc": "Results per page 1-100 (default 12)"
        },
        {
          "name": "pageNo",
          "required": false,
          "example": "1",
          "desc": "Page number 1-100 (default 1)"
        }
      ]
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "Source: Korea Customs item-by-country trade performance (Public Data Portal data.go.kr)"
}

Error handling

All responses are JSON. On failure the proxy returns {"ok": false, "error": {"code", "message"}}. Handle by code:

invalid_token	403. Missing or invalid `X-Agent-Token`. Get a token via /agencatalog/register/ and resend with the header.
throttle	429. One-call-per-second limit exceeded. Wait `retry_after` seconds and retry sequentially (no parallel calls).
agent_limit / institution_limit	429. Daily quota exceeded. Resume after `retry_after_seconds`.
upstream_limit	429. The upstream provider returned an over-quota error. Retry later.
unknown_service	404. Unregistered service. Check the exact service/endpoint name in services.json.
not_found	404. Bad path. Confirm you use `POST /agencatalog/api/call`.

Notes

API keys live only on the server. Clients asking for keys directly cannot use this route.
Each provider has a daily quota. Over-quota calls return 429 and are blocked.
Provider outages or over-quota errors are passed through. Check the error field before retrying.
Attribution: Source: Korea Customs item-by-country trade performance (Public Data Portal data.go.kr)

Last checked: 2026-10-16

AI Crawler · Collection Records