인천항만공사_항만운영 통계정보 조회 서비스

해당 Open API는 외항 선박의 국적에 따른 TEU 처리량 및 입항 실적 통계 정보를 제공하는 기능을 중심으로 구성되어 있습니다. XML 포맷으로 제공되며, 연도, 월, 국가코드, 항코드, 장코드 등의 요청 파라미터를 활용하여 특정 기간 내 항만별 외항선박 입항 건수 및 컨테이너 처리량(TEU)을 조회할 수 있습니다. 응답 항목에는 입항 구분, 국적코드, 입항일시, 외국선적 및 아국선적 TEU, 연월 정보, 항코드 및 장코드 등의 상세 정보가 포함됩니다. 항만 물동량 분석, 물류 정책 수립, 항만 별 국제물류 흐름 파악 및 물류산업의 국가 경쟁력 분석 등에 활용됩니다. 특히 연도별, 국가별, 선박 유형별로 TEU 수치를 비교하여 물류 흐름의 트렌드 변화와 항만 수용능력 분석에 기초자료로 활용될 수 있습니다.

body header item items 결과메세지 결과코드 국가코드 국내OD 내항 OD 년/톤Km 년도 데이터 총 개수 부두코드 북한기항여부 사용여부 생성일시 선박종류 수정자명 아국선 10FT 공컨테이너갯수 아국선 10FT 적컨테이너갯수 아국선 20FT 공컨테이너갯수 아국선 20FT 적컨테이너갯수 아국선 40FT 공컨테이너갯수 아국선 40FT 적컨테이너갯수 아국선 공 TEU 아국선 기타 공컨테이너갯수 아국선 기타 적컨테이너갯수 아국선 일반화물 톤수 아국선 적 TEU 아국선 척수 아국선 총톤수 아국선 컨테이너화물 톤수 연계일시 외국선 10FT 공컨테이너갯수 외국선 10FT 적컨테이너갯수 외국선 20FT 공컨테이너갯수 외국선 20FT 적컨테이너갯수 외국선 40FT 공컨테이너갯수 외국선 40FT 적컨테이너갯수 외국선 공 TEU 외국선 기타 공컨테이너갯수 외국선 기타 적컨테이너갯수 외국선 일반화물 톤수 외국선 적 TEU 외국선 척수 외국선 총톤수 외국선 컨테이너화물 톤수 외내항구분 외내항구분(1:수출입항 2:연안항) 월 일반화물 톤수 입출항구분 지역코드 척수 청코드 총톤수 컨테이너화물 톤수 톤급구분코드 페이지 수

외 4개

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '인증키=값' \
  --data-urlencode '조회 시작 월=01' \
  --data-urlencode '조회 종료 월=01' \
  --data-urlencode '조회년도=2025' \
  --data-urlencode '페이지 번호=1' \
  --data-urlencode '한 페이지 결과 수=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "인증키": "값",
  "조회 시작 월": "01",
  "조회 종료 월": "01",
  "조회년도": "2025",
  "페이지 번호": "1",
  "한 페이지 결과 수": "1",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "인증키": "값",
    "조회 시작 월": "01",
    "조회 종료 월": "01",
    "조회년도": "2025",
    "페이지 번호": "1",
    "한 페이지 결과 수": "1",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())