관세청 품목별 국가별 수출입실적 (품목·국가별 무역통계)

에이전트가 얻을 수 있는 정보

• year(연월 YYYYMM 또는 "총계"), hsCd(HS품목코드), statKor(품목명), statCd(국가코드), statCdCntnKor1(국가명), expWgt(수출중량 kg), expDlr(수출액 달러), impWgt(수입중량 kg), impDlr(수입액 달러), balPayments(무역수지 달러)
  품목·국가별 수출입 규모 조회, 특정 HS코드의 국가별 실적 비교

활용 사례

• 특정 HS 품목코드의 월별 수출입 실적 조회
• 특정 국가의 품목별 수출입 실적 조회
• 품목×국가 수출입 중량·금액·무역수지 확인

등록 API (1)

인증·비용·약관

에이전트 호출 방법

우리 프록시를 통해 호출합니다. 인증이 필요한 기관은 헤더 X-Agent-Token이 있어야 합니다(법령 조회 target=law와 무료 API는 토큰 없이 호출 가능). 토큰 발급 안내는 /agencatalog/register/를 확인하세요. 전체 서비스 목록은 /agencatalog/api/services.json을 참조하세요.

기계용 JSON 스키마

{
  "service": "customs-national-item-trade",
  "name": "관세청 품목별 국가별 수출입실적 (품목·국가별 무역통계)",
  "provider": "관세청",
  "apis": [
    {
      "id": "getNitemtradeList",
      "name": "품목별 국가별 수출입실적 목록조회",
      "params": [
        {
          "name": "strtYymm",
          "required": true,
          "example": "202601",
          "desc": "시작 연월 YYYYMM"
        },
        {
          "name": "endYymm",
          "required": true,
          "example": "202601",
          "desc": "종료 연월 YYYYMM (조회기간 1년 이내)"
        },
        {
          "name": "hsSgn",
          "required": false,
          "example": "8542",
          "desc": "HS 품목코드(접두 매칭, 2~10자리). cntyCd와 함께 지정 시 AND"
        },
        {
          "name": "cntyCd",
          "required": false,
          "example": "US",
          "desc": "국가코드 ISO 2자리(예 US/CN/AE). hsSgn과 함께 지정 시 AND"
        },
        {
          "name": "numOfRows",
          "required": false,
          "example": "12",
          "desc": "한 페이지 결과 수 1~100 (기본 12)"
        },
        {
          "name": "pageNo",
          "required": false,
          "example": "1",
          "desc": "페이지 번호 1~100 (기본 1)"
        }
      ]
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "출처: 관세청 품목별 국가별 수출입실적(공공데이터포털 data.go.kr)"
}

에러 대처

모든 응답은 JSON입니다. 실패 시 {"ok": false, "error": {"code", "message"}} 형태로 반환됩니다. code별 대처 방법은 아래와 같습니다.

이용 시 주의사항

마지막 확인: 2026-10-16