법무부_장단기체류외국인 국적(지역)별 체류외국인 현황 조회서비스

관광, 친지방문 등의 목적으로 입국하여 90일 이내에서 단기간 국내 체류하는 단기체류외국인 및 등록외국인과 외국국적동포 국내거소신고자를 포함하는 장기체류 외국인의 국적(지역)별 현황을 월별로 제공장단기체류외국인, 즉 체류외국인 전체의 국적(지역)별 현황입니다.원본 데이터는 출입국외국인정책본부 홈페이지의 통계월보에서 확인하실 수 있으며 경로는 아래와 같습니다.https://www.immigration.go.kr/immigration/1569/subview.do?enc=Zm5jdDF8QEB8JTJGYmJzJTJGaW1taWdyYXRpb24lMkYyMjclMkY2MDY3OTAlMkZhcnRjbFZpZXcuZG8lM0ZwYXNzd29yZCUzRCUyNnJnc0JnbmRlU3RyJTNEJTI2YmJzQ2xTZXElM0QlMjZyZ3NFbmRkZVN0ciUzRCUyNmlzVmlld01pbmUlM0RmYWxzZSUyNnBhZ2UlM0QxJTI2YmJzT3BlbldyZFNlcSUzRCUyNnNyY2hDb2x1bW4lM0QlMjZzcmNoV3JkJTNEJTI2

body header item items 결과메세지 결과코드 요청 데이터 연도(YYYY) 요청 데이터 월(1-12) 전체 결과 수 체류외국인 국적 체류외국인 수 페이지번호 한 페이지 결과 수

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '요청 데이터 연도(YYYY)=2025' \
  --data-urlencode '요청 데이터 월(1-12)=01' \
  --data-urlencode '페이지번호=1' \
  --data-urlencode '한 페이지 결과 수=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "공공데이터포털에서 받은 인증키": "값",
  "요청 데이터 연도(YYYY)": "2025",
  "요청 데이터 월(1-12)": "01",
  "페이지번호": "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": "발급받은_인증키",
    "공공데이터포털에서 받은 인증키": "값",
    "요청 데이터 연도(YYYY)": "2025",
    "요청 데이터 월(1-12)": "01",
    "페이지번호": "1",
    "한 페이지 결과 수": "1",
}

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