해양수산부_외항화물반출입정보

이 데이터는 해양수산부에서 국내 항만을 통해 반출입되는 외항화물 정보를 제공하기 위해 수집한 데이터입니다. 항만청 코드, 선박 호출부호, 선박 입항연도 등 입력 파라미터를 이용해 데이터를 호출하실 수 있으며, 본 데이터의 주요 내용은 항만명, 입항년도, 화물품목, 해외지역, 반출입구분, 수출입국가(OD), 운임톤 등으로 구성되어 있습니다. 본 데이터는 수출입 화물의 흐름 및 물동량 분석, 특정 항만별 주요 화물 품목 및 반출입 특성 파악, 운임톤 기준 물류수단 계획 수립, 항만 인프라 개선 및 정책 검토, 국가 간 교역 구조 분석 등에 활용될 수 있습니다.

BL번호 UN.No item items 계선장소명 계선장소서브코드 계선장소코드 국내화주코드 국외OD 국외OD명 기항지입항일시 내외항구분 데이터 총 개수 반입반출구분 반입반출구분명 선박국적명 선박국적코드 선박종류명 선박종류코드 선박한글명 선사ID 선사명 신고일시 양하항구명 양하항구코드 용적단위구분 용적단위구분 한글명 용적톤수 운임톤 응답결과 메시지 응답결과 코드 입출항일시 입항년도 입항횟수 적하항구명 적하항구코드 중량톤 최종목적항구코드 컨테이너수 페이지 수 포장종류명 포장종류코드 하역방법명 하역방법코드 하역업체코드 회사한글명 한 페이지 결과 수 항구청명 항구청코드 호출부호 혼적여부 화물분류명 화물분류코드 화물품목코드 화물품목한글명

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '검색을 원하는 선박의 입항연도=2025' \
  --data-urlencode '검색을 원하는 선박의 입항횟수=값' \
  --data-urlencode '검색을 원하는 조회 호출부호=값' \
  --data-urlencode '검색하고자 하는 항만청 코드=11110' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '조회 결과 데이터 최대 개수(최대 50)=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "검색을 원하는 선박의 입항연도": "2025",
  "검색을 원하는 선박의 입항횟수": "값",
  "검색을 원하는 조회 호출부호": "값",
  "검색하고자 하는 항만청 코드": "11110",
  "공공데이터포털에서 받은 인증키": "값",
  "조회 결과 데이터 최대 개수(최대 50)": "값",
});

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": "발급받은_인증키",
    "검색을 원하는 선박의 입항연도": "2025",
    "검색을 원하는 선박의 입항횟수": "값",
    "검색을 원하는 조회 호출부호": "값",
    "검색하고자 하는 항만청 코드": "11110",
    "공공데이터포털에서 받은 인증키": "값",
    "조회 결과 데이터 최대 개수(최대 50)": "값",
}

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