총조사 주요지표
즐겨찾기
총조사 주요지표 조회 API
총조사 주요지표 조회 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/population.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
*인구/주택 관련 데이터 인 경우 2015년(2015) ~ 2023년(2023) *사업체 관련 데이터 인 경우 2000년(2000) ~ 2023년(2023) *농가/임가/어가 관련 데이터 인 경우 2000년 : 2000 2005년 : 2005 2010년 : 2010 2015년 : 2015 2020년 : 2020 |
필수 | 기준연도 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 1단계 하위 행정구역 정보 요청 : 1 2단계 하위 행정구역 정보 요청 : 2 (default : 1) |
선택 | 하위 통계 정보 유무 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| tot_ppltn | String | 총인구 |
| avg_age | 소수점 한자리 | 평균나이(세) |
| ppltn_dnsty | 소수점 두자리 | 인구밀도(명/㎢) |
| aged_child_idx | String | 노령화지수(일백명당 명) |
| oldage_suprt_per | String | 노년부양비(일백명당 명) |
| juv_suprt_per | String | 유년부양비(일백명당 명) |
| tot_family | String | 총가구 |
| avg_fmember_cnt | 소수점 한자리 | 평균가구원수 |
| tot_house | String | 총주택 |
| nongga_cnt | String | 농가(가구) |
| nongga_ppltn | String | 농가 인구 |
| imga_cnt | String | 임가(가구) |
| imga_ppltn | String | 임가 인구 |
| naesuoga_cnt | String | 내수면 어가(가구) |
| naesuoga_ppltn | String | 내수면 어가 인구 |
| haesuoga_cnt | String | 해수면 어가(가구) |
| haesuoga_ppltn | String | 해수면 어가인구 |
| employee_cnt | String | 종업원수(전체 사업체) |
| corp_cnt | String | 사업체수(전체 사업체) |
{
"id": "API_0301",
"result": [
{
"imga_ppltn": "N/A",
"adm_cd": "11010",
"tot_house": "39727",
"ppltn_dnsty": "6237",
"tot_ppltn": "148920",
"aged_child_idx": "106.8",
"corp_cnt": "36779",
"imga_cnt": "N/A",
"employee_cnt": "236758",
"haesuoga_cnt": "N/A",
"juv_suprt_per": "16.2",
"haesuoga_ppltn": "N/A",
"tot_family": "57807",
"adm_nm": "종로구",
"nongga_cnt": "49",
"naesuoga_ppltn": "N/A",
"avg_age": "39.2",
"avg_fmember_cnt": "2.5",
"nongga_ppltn": "156",
"naesuoga_cnt": "N/A",
"oldage_suprt_per": "17.3"
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "pqOr_API_0301_1461634087803"
}
(인구주택총조사) 인구 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/searchpopulation.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2015년 : 2015 2016년 : 2016 2017년 : 2017 2018년 : 2018 2019년 : 2019 2020년 : 2020 2021년 : 2021 2022년 : 2022 2023년 : 2023 |
필수 | 기준연도 |
| gender |
0 : 전체 1 : 남자 2 : 여자 (default : 0) |
선택 | 성별 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 1단계 하위 행정구역 정보 요청 : 1 2단계 하위 행정구역 정보 요청 : 2 (default : 1) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| age_type |
연령타입코드표 참고
|
선택 | 연령타입 |
| edu_level |
교육정보코드표 참고
|
선택 | 교육정도 * 2010년까지 제공, 2015년도 이후는 제공하지 않음 |
| mrg_state |
1 : 미혼 2 : 배우자 있음 3 : 사별 4 : 이혼 5 : 미상 |
선택 | 혼인상태 * 2010년까지 제공, 2015년도 이후는 제공하지 않음 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| population | String | 인구수 |
{
"id": "API_0302",
"result": [
{
"adm_cd": "11040550",
"adm_nm": "사근동",
"population": 3
},
{
"adm_cd": "11040680",
"adm_nm": "성수2가3동",
"population": 2
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "O3*b_API_0302_1419229378262"
}
(인구주택총조사) 가구 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/household.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2015년 : 2015 2016년 : 2016 2017년 : 2017 2018년 : 2018 2019년 : 2019 2020년 : 2020 2021년 : 2021 2022년 : 2022 2023년 : 2023 |
필수 | 기준연도 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 1단계 하위 행정구역 정보 요청 : 1 2단계 하위 행정구역 정보 요청 : 2 (default : 1) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| household_type |
세대구성코드표 참고
|
선택 | 세대구성별 다중선택 시 1,2,3 형태로 작성 |
| ocptn_type |
점유형태코드 참고
|
선택 | 점유형태 다중선택 시 1,2,3 형태로 작성 * 2010년까지 제공, 2015년도 이후는 제공하지 않음 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| household_cnt | String | 가구수 |
| family_member_cnt | String | 총 가구원 수 |
| avg_family_member_cnt | String | 평균가구원수 |
{
"id": "API_0305",
"result": [
{
"family_member_cnt": 2518,
"adm_cd": "11040520",
"adm_nm": "왕십리2동",
"avg_family_member_cnt": "2",
"household_cnt": "1248"
},
{
"family_member_cnt": 3345,
"adm_cd": "11040540",
"adm_nm": "마장동",
"avg_family_member_cnt": "2",
"household_cnt": "1660"
},
{
"family_member_cnt": 1420,
"adm_cd": "11040550",
"adm_nm": "사근동",
"avg_family_member_cnt": "2",
"household_cnt": "705"
},
{
"family_member_cnt": 2071,
"adm_cd": "11040560",
"adm_nm": "행당1동",
"avg_family_member_cnt": "2",
"household_cnt": "1028"
},
{
"family_member_cnt": 3598,
"adm_cd": "11040570",
"adm_nm": "행당2동",
"avg_family_member_cnt": "2",
"household_cnt": "1784"
},
{
"family_member_cnt": 1954,
"adm_cd": "11040580",
"adm_nm": "응봉동",
"avg_family_member_cnt": "2",
"household_cnt": "963"
},
{
"family_member_cnt": 2329,
"adm_cd": "11040590",
"adm_nm": "금호1가동",
"avg_family_member_cnt": "2",
"household_cnt": "1162"
},
{
"family_member_cnt": 2285,
"adm_cd": "11040620",
"adm_nm": "금호4가동",
"avg_family_member_cnt": "2",
"household_cnt": "1136"
},
{
"family_member_cnt": 2504,
"adm_cd": "11040650",
"adm_nm": "성수1가1동",
"avg_family_member_cnt": "2",
"household_cnt": "1244"
},
{
"family_member_cnt": 2038,
"adm_cd": "11040660",
"adm_nm": "성수1가2동",
"avg_family_member_cnt": "2",
"household_cnt": "1021"
},
{
"family_member_cnt": 2595,
"adm_cd": "11040670",
"adm_nm": "성수2가1동",
"avg_family_member_cnt": "2",
"household_cnt": "1296"
},
{
"family_member_cnt": 1664,
"adm_cd": "11040680",
"adm_nm": "성수2가3동",
"avg_family_member_cnt": "2",
"household_cnt": "827"
},
{
"family_member_cnt": 1513,
"adm_cd": "11040690",
"adm_nm": "송정동",
"avg_family_member_cnt": "2",
"household_cnt": "753"
},
{
"family_member_cnt": 1538,
"adm_cd": "11040700",
"adm_nm": "용답동",
"avg_family_member_cnt": "2",
"household_cnt": "776"
},
{
"family_member_cnt": 3605,
"adm_cd": "11040710",
"adm_nm": "왕십리도선동",
"avg_family_member_cnt": "2",
"household_cnt": "1795"
},
{
"family_member_cnt": 3583,
"adm_cd": "11040720",
"adm_nm": "금호2·3가동",
"avg_family_member_cnt": "2",
"household_cnt": "1774"
},
{
"family_member_cnt": 4297,
"adm_cd": "11040730",
"adm_nm": "옥수동",
"avg_family_member_cnt": "2",
"household_cnt": "2139"
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "8EeN_API_0305_1650327391243"
}
(인구주택총조사) 주택 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/house.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2015년 : 2015 2016년 : 2016 2017년 : 2017 2018년 : 2018 2019년 : 2019 2020년 : 2020 2021년 : 2021 2022년 : 2022 2023년 : 2023 |
필수 | 기준연도 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 1단계 하위 행정구역 정보 요청 : 1 2단계 하위 행정구역 정보 요청 : 2 (default : 1) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| house_type |
주택유형 코드 참고
|
선택 | 주택유형 |
| const_year |
건축연도 코드 참고
|
선택 | 건축연도(from) |
| house_area_cd |
주택면적 코드 참고
|
선택 | 주택면적코드 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| house_cnt | String | 주택수(호) |
{
"id": "API_0306",
"result": [
{
"house_cnt": 1,
"adm_cd": "11050",
"adm_nm": "광진구"
},
{
"house_cnt": 1,
"adm_cd": "11060",
"adm_nm": "동대문구"
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "*SaP_API_0306_1419238053496"
}
(전국사업체조사) 사업체 통계 조회 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/company.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year | 2000년 ~ 2023년 | 필수 | 기준연도 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 1단계 하위 행정구역 정보 요청 : 1 2단계 하위 행정구역 정보 요청 : 2 (default : 1) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| class_code | "산업분류 API"의 조회 항목 | 선택 | 산업분류코드 테마코드, 산업체 코드는 같이 사용할 수 없음 |
| theme_cd |
테마코드표 참고
|
선택 | 테마코드 테마코드, 산업체코드는 같이 사용할 수 없음 -신규 테마코드(영문자가 앞에 있는 코드)는 2019년부터 ~ 조회가능 -구 테마코드(숫자로만 이루어진 코드)는 2006년부터 ~ 조회가능 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| corp_cnt | String | 사업체수(개) |
| tot_worker | String | 종사자수(명) |
{
"id": "API_0304",
"result": [
{
"adm_cd": "11010530",
"adm_nm": "사직동",
"corp_cnt": "817",
"tot_worker": "3588"
},
{
"adm_cd": "11010540",
"adm_nm": "삼청동",
"corp_cnt": "215",
"tot_worker": "1208"
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "ZAye_API_0304_1461635199133"
}
(전국사업체조사) 산업분류 코드 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/industrycode.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| class_deg | String | 필수 | 8,9,10차 산업분류코드 2000~2005년 : 8 2006~2016년 : 9 2017년~ : 10 |
| class_code | String | 선택 | 산업분류코드 조회의 기준이 되는 분류코드 변수, 이 변수를 기준으로 하위 분류코드의 리스트가반환되며, null인 경우 최상위 분류코드 리스트 반환 최대 6자리(5단계) 1-2-1-1-1자리로 구성 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| class_code | String | 산업분류코드 |
| class_nm | String | 산업분류코드명 |
{
"id": "API_0303",
"result": [
{
"class_code": "A011",
"class_nm": "작물 재배업"
},
{
"class_code": "A012",
"class_nm": "축산업"
},
{
"class_code": "A013",
"class_nm": "작물재배 및 축산 복합농업"
},
{
"class_code": "A014",
"class_nm": "작물재배 및 축산 관련 서비스업"
},
{
"class_code": "A015",
"class_nm": "수렵 및 관련 서비스업"
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "i5Bm_API_0303_1419231536360"
}
(농림어업총조사) 농가 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/farmhousehold.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2000년 : 2000 2005년 : 2005 2010년 : 2010 2015년 : 2015 2020년 : 2020 |
필수 | 기준연도 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 하위 행정구역 정보 요청 : 1 (default : 0) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| farm_cnt | String | 단위 : 가구 농가 수 |
| population | String | 단위 : 명 농가인구 수 |
| avg_population | String | 단위 : 명 농가 평균 인구 수 |
{
"id": "API_0307",
"result": [
{
"adm_cd": "11030",
"farm_cnt": 31,
"adm_nm": "용산구",
"avg_population": "3",
"population": 100
},
{
"adm_cd": "11160",
"farm_cnt": 433,
"adm_nm": "강서구",
"avg_population": "3",
"population": 1439
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "*oQi_API_0307_1419239511295"
}
(농림어업총조사) 임가 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/forestryhousehold.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2005년 : 2005 2010년 : 2010 2015년 : 2015 2020년 : 2020 |
필수 | 기준연도 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 하위 행정구역 정보 요청 : 1 (default : 0) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| forestry_cnt | String | 임가수(가구) |
| population | String | 임가인구수(명) |
| avg_population | String | 임가평균인구수(명) |
{
"id": "API_0308",
"result": [
{
"adm_cd": "11030",
"adm_nm": "용산구",
"forestry_cnt": 1,
"avg_population": "3",
"population": 3
},
{
"adm_cd": "11160",
"adm_nm": "강서구",
"forestry_cnt": 17,
"avg_population": "3",
"population": 52
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "fNI3_API_0308_1419239944777"
}
(농림어업총조사) 어가(해수면/내수면) 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/fisheryhousehold.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2005년 : 2005 2010년 : 2010 2015년 : 2015 2020년 : 2020 |
필수 | 기준연도 |
| oga_div |
전체 : 0 내수면어가 : 1 해수면어가 : 2 |
필수 | 어가구분 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 하위 행정구역 정보 요청 : 1 (default : 0) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| fishery_cnt | String | 단위 : 가구 어가 수 |
| population | String | 단위 : 명 어가인구 수 |
| avg_population | String | 단위 : 명 어가 평균 인구 수 |
{
"id": "API_0309",
"result": [
{
"adm_cd": "11030",
"fishery_cnt": 1,
"adm_nm": "용산구",
"avg_population": "6",
"population": 6
},
{
"adm_cd": "11230",
"fishery_cnt": 1,
"adm_nm": "강남구",
"avg_population": "2",
"population": 2
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "aGCG_API_0309_1419240211967"
}
(농림어업총조사) 농가ㆍ임가ㆍ어가 가구원 통계 제공 API
https://sgisapi.kostat.go.kr/OpenAPI3/stats/householdmember.json
| 요청변수 | 값 | Optional | 설명 |
|---|---|---|---|
| accessToken | String | 필수 | 액세스토큰 |
| year |
2000년 : 2000 2005년 : 2005 2010년 : 2010 2015년 : 2015 2020년 : 2020 |
필수 | 기준연도 |
| data_type |
농가 : 1 임가 : 2 해수면어가 : 3 내수면어가 : 4 |
필수 | 가구타입 |
| adm_cd |
non : 전국 시도 리스트 2자리 : 해당 시도 5자리 : 해당 시군구 8자리 : 해당 읍면동 |
선택 | 행정구역코드 "영역검색유무"가 행정구역일 경우 |
| low_search |
행정구역코드에 해당하는 정보만 요청 : 0 하위 행정구역 정보 요청 : 1 (default : 0) |
선택 | 하위 통계 정보 유무 "영역검색유무"가 행정구역일 경우 |
| gender |
총합 : 0 남자 : 1 여자 : 2 |
선택 | 성별 |
| age_from | 0 ~ 150 | 선택 | 나이(from) |
| age_to | 0 ~ 150 | 선택 | 나이(to) |
| 출력변수 | 값 | 설명 |
|---|---|---|
| adm_cd | String | 행정구역코드 |
| adm_nm | String | 행정구역명 * 집계구에서는 나오지 않음 |
| population | String | 가구원수(명) |
{
"id": "API_0310",
"result": [
{
"adm_cd": "11030",
"adm_nm": "용산구",
"population": 1
},
{
"adm_cd": "11160",
"adm_nm": "강서구",
"population": 12
}
],
"errMsg": "Success",
"errCd": 0,
"trId": "r9fc_API_0310_1419240710477"
}