Korea Customs Service

Korea Customs Trade Summary (import/export trade statistics)

Korea Customs Service trade summary (getNewtradeList; XML source converted to JSON). Call GET /api/trade directly without a key (period required). The data.go.kr key is registered on the server — ready to use. Returns monthly national totals for export/import counts and amounts (USD) and the trade balance.

⚡ Trade summary simple call

GET /api/trade?strtYymm=202601&endYymm=202603

Use this address first for import/export and trade statistics. No key required, strtYymm/endYymm (YYYYMM) mandatory. Server key registered — ready to use.

What agents get

year(YYYYMM), expCnt(export count), expDlr(export value USD), impCnt(import count), impDlr(import value USD), balPayments(trade balance USD)
Monthly export/import volume and trade balance lookup, period aggregation of trade statistics

Use cases

Look up export/import counts and amounts for a given month
Query export/import trend over a period (start month to end month)
Check the trade balance (exports minus imports)

Registered APIs (1)

Trade summary list getNewtradeList

XML source converted to JSON by the simple API. strtYymm/endYymm (YYYYMM) required. National totals only (no item/country filtering). The response includes a final row with year="total"

strtYymm Required — Start month YYYYMM e.g. 202601
endYymm Required — End month YYYYMM e.g. 202603
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/expCnt/expDlr/impCnt/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/trade).
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 Service Trade Summary (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-trade-gw",
  "name": "Korea Customs Trade Summary (import/export trade statistics)",
  "provider": "Korea Customs Service",
  "apis": [
    {
      "id": "getNewtradeList",
      "name": "Trade summary list",
      "params": [
        {
          "name": "strtYymm",
          "required": true,
          "example": "202601",
          "desc": "Start month YYYYMM"
        },
        {
          "name": "endYymm",
          "required": true,
          "example": "202603",
          "desc": "End month YYYYMM"
        },
        {
          "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 Service trade summary (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 Service trade summary (Public Data Portal data.go.kr)

Last checked: 2026-10-16

AI Crawler · Collection Records