법무부_외국인체류데이터(체류외국인관리)

체류자격 대분류별 국적별(지역별)을 성별로 분류하여 제공해당 시점(연도말) 기준 통계이며 원본 통계는 출입국외국인 정책본부 홈페이지 통계연보에서 확인하실 수 있습니다. 아래 URL을 통해서 접속하실 수 있습니다.https://www.immigration.go.kr/immigration/1570/subview.do해당연도 통계연보 클릭-엑셀 압축파일 - 국적(지역) 및 체류자격별 체류외국인 현황연도별 데이터이며 통계연보는 매년 6월말경 게재됩니다.해당 통계는 불법체류자 등 체류기간 도과자 모두 포함한 전체 외국인 입니다.

A1(외교) A2(공무) B1(사증면제) B2(관광통과) C1(일시취재) C3(단기방문) C4(단기취업) D1(문화예술) D10(구직) D2(유학) D3(기술연수) D4(일반연수) D5(취재) D6(종교) D7(주재) D8(기업투자) D9(무역경영) E1(교수) E10(선원취업) E2(회화) E3(연구) E4(기술지도) E5(전문직업) E6(예술흥행) E7(특정활동) E8 E9(비전문취업) F1(방문동거) F2(거주) F3(동반) F4(재외동포) F5(영주) F6(결혼이민) G1(기타) H1(관광취업) H2(방문취업) T1(관광상륙) 국적 기타 대륙 성별

확인된 엔드포인트 — 공개된 OpenAPI 스펙에서 가져온 실제 호출 주소입니다. 인증키만 바꾸면 그대로 돌아갑니다.

curl -G 'https://api.odcloud.kr/api/3069975/v1/uddi:1936f909-2f19-484c-a598-f7d4371d85e2' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode 'page=1' \
  --data-urlencode 'perPage=1' \
  --data-urlencode 'returnType=json'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "page": "1",
  "perPage": "1",
  "returnType": "json",
});

const res = await fetch(`https://api.odcloud.kr/api/3069975/v1/uddi:1936f909-2f19-484c-a598-f7d4371d85e2?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "page": "1",
    "perPage": "1",
    "returnType": "json",
}

r = requests.get("https://api.odcloud.kr/api/3069975/v1/uddi:1936f909-2f19-484c-a598-f7d4371d85e2", params=params, timeout=15)
r.raise_for_status()
print(r.json())