Guide | TMAP 대중교통 API

진입 역 기준 열차 혼잡도

특정 역으로 진입하는 열차의 혼잡도를 제공합니다.

지정한 운행 시간대(05:30 ~ 23:50)에 특정 역으로 진입하는 일반/급행 열차에 대해 시작역(발), 종착역(행), 이전역 조합에 따른 혼잡도 데이터를 10분 간격으로 제공합니다.
특정 시작역(발)과 종착역(행)의 조합으로 운행하지 않는 시간대에는 혼잡도 값이 '0'으로 제공될 수 있습니다.
요일 및 시간대를 입력하지 않으면 요청 시간을 기준으로 동일한 요일 및 시간대 데이터를 반환합니다.

API 서비스에 대한 모든 요청은 HTTPS를 사용합니다.
요청 헤더에 발급 받은 appKey 값을 반드시 포함해야 합니다.
응답 형식은 JSON을 지원합니다. 응답 실패 시 [에러코드]를 확인하세요.
요청 파라미터는 앰퍼샌드(&)를 사용하여 구분합니다.

API URL

							https://apis.openapi.sk.com/transit/puzzle/subway/congestion/stat/train?routeNm={노선명}&stationNm={역명칭}

Basic Information

Name	Description
Protocol /HTTP Method	GET Method
Pre-Conditions	The Accept value of RequestHeader supports the following values. application / json : Data response in json format.
OAuth	NO

Name

Description

Protocol /HTTP Method

GET Method

Pre-Conditions

The Accept value of RequestHeader supports the following values.

application / json : Data response in json format.

OAuth

Request

Parameters

Name	Data Type	Mandatory	Example	Default	Description
routeNm	String	Y	1호선	내용없음	지하철 노선 명칭 지하철 노선/역 명칭 리스트 참조
stationNm	String	Y	서울역	내용없음	지하철 역 명칭 지하철 노선/역 명칭 리스트 참조
dow	String	N	MON	내용없음	요청 요일 검색 기준 요일입니다. 요일을 입력하지 않으면 요청 시간을 기준으로 동일한 요일의 데이터를 반환합니다. 요일 구분 : MON, TUE, WED, THU, FRI, SAT, SUN
hh	String	N	08	내용없음	요청 시간 검색 기준 시간입니다. 시간을 입력하지 않으면 요청 시간을 기준으로 동일한 시간대의 데이터를 반환합니다. 시간 지정 범위 : 05 ~ 23

Request Sample

									
curl --request GET \
     --url 'https://apis.openapi.sk.com/transit/puzzle/subway/congestion/stat/train?routeNm=1호선&stationNm=서울역&dow=MON&hh=08'
	--header 'appkey: {발급 받은 appKey}'

Response

Parameters

Name	Data Type	Mandatory	Example	Description
Status	node	내용이 없습니다.	내용이 없습니다.	검색 결과
code	string	내용이 없습니다.	00 (success)	응답코드
message	string	내용이 없습니다.	success	요청 성공 여부
totalCount	int	내용이 없습니다.	1	검색 결과 데이터 건수
contents	node	내용이 없습니다.	내용이 없습니다.	지정한 진입 역의 정보
subwayLine	string	내용이 없습니다.	1호선	지하철 호선 정보
stationName	string	내용이 없습니다.	서울역	역 이름
stationCode	string	내용이 없습니다.	133(1호선 서울역)	역 코드 본선: OOO (코드 세 자리) 지선: OOO-O (본선 코드 세 자리 + 추가 코드) 2호선 성수 지선(211-0 ~ 211-4), 2호선 신도림 지선(234-0 ~ 234-4) 순환선: OOO-R (본선 코드 세 자리 + R) 2호선 성수 순환선(211-R)
stat	array	내용이 없습니다.	내용이 없습니다.	지정한 역에 진입하는 열차의 시작역, 종착역, 이전역 및 노선 정보
startStationCode	string	내용이 없습니다.	100	시작역 코드
startStationName	string	내용이 없습니다.	소요산역	시작역 이름
endStationCode	string	내용이 없습니다.	141	종착역 코드
endStationName	string	내용이 없습니다.	구로역	종착역 이름
prevStationCode	string	내용이 없습니다.	132	이전역 코드
prevStationName	string	내용이 없습니다.	시청역	이전역 이름
updnLine	int	내용이 없습니다.	1	상하행선 또는 순환선인 경우의 내외선 정보 0: 상행선/외선 1: 하행선/내선
directAT	int	내용이 없습니다.	0	일반 또는 급행 열차 정보 0: 일반 열차 1: 급행 열차
data	array	내용이 없습니다.	내용이 없습니다.	지정한 시간대에 지정한 역에 진입하는 열차의 10분 단위 혼잡도 검색 결과
dow	string	내용이 없습니다.	MON	검색 기준 요일 요일 구분: MON, TUE, WED, THU, FRI, SAT, SUN
hh	string	내용이 없습니다.	08	검색 기준 시간 시간 지정 범위: 05 ~ 23
mm	string	내용이 없습니다.	10	10분 단위 시간 시간 범위: 00 ~ 50 (10분 단위)
congestionTrain	int	내용이 없습니다.	36	해당 시간대에 지정한 역에 진입하는 열차의 혼잡도 단위 : %
statStartDate	string	내용이 없습니다.	20220515	통계 시작 일자 시작 일자: YYYYMMDD
statEndDate	string	내용이 없습니다.	20220814	통계 종료 일자 종료 일자: YYYYMMDD

Response Sample

									
{
  "status": {
    "code": "00",
    "message": "success",
    "totalCount": 1
  },
  "contents": {
    "subwayLine": "1호선",
    "stationName": "서울역",
    "stationCode": "133",
    "stat": [
	...

Error code index

HTTP Status Code	Error Code	Error Message
204	204	No Content
400	400	INVALID_DOW
		INVALID_DATE
		Bad Request
		No required parameters
404	404	NOT_FOUND_DATA

지하철 노선/역 명칭

본선과 지선을 분리하여 서비스하고 있으며,

노선/역 명칭을 정확하게 입력해주세요.

노선명	역 명칭
1호선	소요산역
1호선	동두천역
1호선	보산역
1호선	동두천중앙역
1호선	지행역
1호선	덕정역
1호선	덕계역
1호선	양주역
1호선	녹양역
1호선	가능역
1호선	의정부역
1호선	회룡역
1호선	망월사역
1호선	도봉산역
1호선	도봉역
1호선	방학역
1호선	창동역
1호선	녹천역
1호선	월계역
1호선	광운대역
1호선	석계역
1호선	신이문역
1호선	외대앞역
1호선	회기역
1호선	청량리역
1호선	제기동역
1호선	신설동역
1호선	동묘앞역
1호선	동대문역
1호선	종로5가역
1호선	종로3가역
1호선	종각역
1호선	시청역
1호선	서울역
1호선	남영역
1호선	용산역
1호선	노량진역
1호선	대방역
1호선	신길역
1호선	영등포역
1호선	신도림역
1호선	구로역
1호선	구일역
1호선	개봉역
1호선	오류동역
1호선	온수역
1호선	역곡역
1호선	소사역
1호선	부천역
1호선	중동역
1호선	송내역
1호선	부개역
1호선	부평역
1호선	백운역
1호선	동암역
1호선	간석역
1호선	주안역
1호선	도화역
1호선	제물포역
1호선	도원역
1호선	동인천역
1호선	인천역
1호선	가산디지털단지역
1호선	독산역
1호선	금천구청역
1호선	광명역
1호선	석수역
1호선	관악역
1호선	안양역
1호선	명학역
1호선	금정역
1호선	군포역
1호선	당정역
1호선	의왕역
1호선	성균관대역
1호선	화서역
1호선	수원역
1호선	세류역
1호선	병점역
1호선	서동탄역
1호선	세마역
1호선	오산대역
1호선	오산역
1호선	진위역
1호선	송탄역
1호선	서정리역
1호선	평택지제역
1호선	평택역
1호선	성환역
1호선	직산역
1호선	두정역
1호선	천안역
1호선	봉명역
1호선	쌍용역
1호선	아산역
1호선	탕정역
1호선	배방역
1호선	온양온천역
1호선	신창역
2호선	시청역
2호선	을지로입구역
2호선	을지로3가역
2호선	을지로4가역
2호선	동대문역사문화공원역
2호선	신당역
2호선	상왕십리역
2호선	왕십리역
2호선	한양대역
2호선	뚝섬역
2호선	성수역
2호선	건대입구역
2호선	구의역
2호선	강변역
2호선	잠실나루역
2호선	잠실역
2호선	잠실새내역
2호선	종합운동장역
2호선	삼성역
2호선	선릉역
2호선	역삼역
2호선	강남역
2호선	교대역
2호선	서초역
2호선	방배역
2호선	사당역
2호선	낙성대역
2호선	서울대입구역
2호선	봉천역
2호선	신림역
2호선	신대방역
2호선	구로디지털단지역
2호선	대림역
2호선	신도림역
2호선	문래역
2호선	영등포구청역
2호선	당산역
2호선	합정역
2호선	홍대입구역
2호선	신촌역
2호선	이대역
2호선	아현역
2호선	충정로역
2호선성수지선	성수역
2호선성수지선	용답역
2호선성수지선	신답역
2호선성수지선	용두역
2호선성수지선	신설동역
2호선신도림지선	신도림역
2호선신도림지선	도림천역
2호선신도림지선	양천구청역
2호선신도림지선	신정네거리역
2호선신도림지선	까치산역
3호선	대화역
3호선	주엽역
3호선	정발산역
3호선	마두역
3호선	백석역
3호선	대곡역
3호선	화정역
3호선	원당역
3호선	원흥역
3호선	삼송역
3호선	지축역
3호선	구파발역
3호선	연신내역
3호선	불광역
3호선	녹번역
3호선	홍제역
3호선	무악재역
3호선	독립문역
3호선	경복궁역
3호선	안국역
3호선	종로3가역
3호선	을지로3가역
3호선	충무로역
3호선	동대입구역
3호선	약수역
3호선	금호역
3호선	옥수역
3호선	압구정역
3호선	신사역
3호선	잠원역
3호선	고속터미널역
3호선	교대역
3호선	남부터미널역
3호선	양재역
3호선	매봉역
3호선	도곡역
3호선	대치역
3호선	학여울역
3호선	대청역
3호선	일원역
3호선	수서역
3호선	가락시장역
3호선	경찰병원역
3호선	오금역
4호선	진접역
4호선	오남역
4호선	별내별가람역
4호선	당고개역
4호선	상계역
4호선	노원역
4호선	창동역
4호선	쌍문역
4호선	수유역
4호선	미아역
4호선	미아사거리역
4호선	길음역
4호선	성신여대입구역
4호선	한성대입구역
4호선	혜화역
4호선	동대문역
4호선	동대문역사문화공원역
4호선	충무로역
4호선	명동역
4호선	회현역
4호선	서울역
4호선	숙대입구역
4호선	삼각지역
4호선	신용산역
4호선	이촌역
4호선	동작역
4호선	이수역
4호선	사당역
4호선	남태령역
4호선	선바위역
4호선	경마공원역
4호선	대공원역
4호선	과천역
4호선	정부과천청사역
4호선	인덕원역
4호선	평촌역
4호선	범계역
4호선	금정역
4호선	산본역
4호선	수리산역
4호선	대야미역
4호선	반월역
4호선	상록수역
4호선	한대앞역
4호선	중앙역
4호선	고잔역
4호선	초지역
4호선	안산역
4호선	신길온천역
4호선	정왕역
4호선	오이도역
5호선	방화역
5호선	개화산역
5호선	김포공항역
5호선	송정역
5호선	마곡역
5호선	발산역
5호선	우장산역
5호선	화곡역
5호선	까치산역
5호선	신정역
5호선	목동역
5호선	오목교역
5호선	양평역
5호선	영등포구청역
5호선	영등포시장역
5호선	신길역
5호선	여의도역
5호선	여의나루역
5호선	마포역
5호선	공덕역
5호선	애오개역
5호선	충정로역
5호선	서대문역
5호선	광화문역
5호선	종로3가역
5호선	을지로4가역
5호선	동대문역사문화공원역
5호선	청구역
5호선	신금호역
5호선	행당역
5호선	왕십리역
5호선	마장역
5호선	답십리역
5호선	장한평역
5호선	군자역
5호선	아차산역
5호선	광나루역
5호선	천호역
5호선	강동역
5호선	길동역
5호선	굽은다리역
5호선	명일역
5호선	고덕역
5호선	상일동역
5호선	강일역
5호선	미사역
5호선	하남풍산역
5호선	하남시청역
5호선	하남검단산역
5호선	둔촌동역
5호선	올림픽공원역
5호선	방이역
5호선	오금역
5호선	개롱역
5호선	거여역
5호선	마천역
6호선	응암역
6호선	역촌역
6호선	불광역
6호선	독바위역
6호선	연신내역
6호선	구산역
6호선	새절역
6호선	증산역
6호선	디지털미디어시티역
6호선	월드컵경기장역
6호선	마포구청역
6호선	망원역
6호선	합정역
6호선	상수역
6호선	광흥창역
6호선	대흥역
6호선	공덕역
6호선	효창공원앞역
6호선	삼각지역
6호선	녹사평역
6호선	이태원역
6호선	한강진역
6호선	버티고개역
6호선	약수역
6호선	청구역
6호선	신당역
6호선	동묘앞역
6호선	창신역
6호선	보문역
6호선	안암역
6호선	고려대역
6호선	월곡역
6호선	상월곡역
6호선	돌곶이역
6호선	석계역
6호선	태릉입구역
6호선	화랑대역
6호선	봉화산역
6호선	신내역
7호선	장암역
7호선	도봉산역
7호선	수락산역
7호선	마들역
7호선	노원역
7호선	중계역
7호선	하계역
7호선	공릉역
7호선	태릉입구역
7호선	먹골역
7호선	중화역
7호선	상봉역
7호선	면목역
7호선	사가정역
7호선	용마산역
7호선	중곡역
7호선	군자역
7호선	어린이대공원역
7호선	건대입구역
7호선	뚝섬유원지역
7호선	청담역
7호선	강남구청역
7호선	학동역
7호선	논현역
7호선	반포역
7호선	고속터미널역
7호선	내방역
7호선	이수역
7호선	남성역
7호선	숭실대입구역
7호선	상도역
7호선	장승배기역
7호선	신대방삼거리역
7호선	보라매역
7호선	신풍역
7호선	대림역
7호선	남구로역
7호선	가산디지털단지역
7호선	철산역
7호선	광명사거리역
7호선	천왕역
7호선	온수역
7호선	까치울역
7호선	부천종합운동장역
7호선	춘의역
7호선	신중동역
7호선	부천시청역
7호선	상동역
7호선	삼산체육관역
7호선	굴포천역
7호선	부평구청역
7호선	산곡역
7호선	석남역
8호선	암사역
8호선	천호역
8호선	강동구청역
8호선	몽촌토성역
8호선	잠실역
8호선	석촌역
8호선	송파역
8호선	가락시장역
8호선	문정역
8호선	장지역
8호선	복정역
8호선	남위례역
8호선	산성역
8호선	남한산성입구역
8호선	단대오거리역
8호선	신흥역
8호선	수진역
8호선	모란역
9호선	개화역
9호선	김포공항역
9호선	공항시장역
9호선	신방화역
9호선	마곡나루역
9호선	양천향교역
9호선	가양역
9호선	증미역
9호선	등촌역
9호선	염창역
9호선	신목동역
9호선	선유도역
9호선	당산역
9호선	국회의사당역
9호선	여의도역
9호선	샛강역
9호선	노량진역
9호선	노들역
9호선	흑석역
9호선	동작역
9호선	구반포역
9호선	신반포역
9호선	고속터미널역
9호선	사평역
9호선	신논현역
9호선	언주역
9호선	선정릉역
9호선	삼성중앙역
9호선	봉은사역
9호선	종합운동장역
9호선	삼전역
9호선	석촌고분역
9호선	석촌역
9호선	송파나루역
9호선	한성백제역
9호선	올림픽공원역
9호선	둔촌오륜역
9호선	중앙보훈병원역
공항철도	서울역
공항철도	공덕역
공항철도	홍대입구역
공항철도	디지털미디어시티역
공항철도	마곡나루역
공항철도	김포공항역
공항철도	계양역
공항철도	검암역
공항철도	청라국제도시역
공항철도	영종역
공항철도	운서역
공항철도	공항화물청사역
공항철도	인천공항1터미널역
공항철도	인천공항2터미널역
신분당선	신사역
신분당선	논현역
신분당선	신논현역
신분당선	강남역
신분당선	양재역
신분당선	양재시민의숲역
신분당선	청계산입구역
신분당선	판교역
신분당선	정자역
신분당선	미금역
신분당선	동천역
신분당선	수지구청역
신분당선	성복역
신분당선	상현역
신분당선	광교중앙역
신분당선	광교역

DOCS

진입 역 기준 열차 혼잡도