OpenAPI 정의서 · 2019-03-18 · "trId": "DUmk_API_0301_1496648537644" } 응답 에러코드 응답코드(결과코드) 설명 0 정상 -401 필수파라미터 누락 -100 검색결과

OpenAPI 정의서

- 2 -

OpenAPI 정의서

통계청 SGIS 오픈플랫폼

OpenAPI 활용가이드_v1.0

서비스 명세 .............................................................................................................................................................. 4

1. 인증 API .............................................................................................................................................................. 4

2. Javascript 제공 API ........................................................................................................................................... 4

3. 좌표변환 API ....................................................................................................................................................... 5

4. 총조사 주요지표 API.......................................................................................................................................... 6

5. 인구통계 조건검색 API ...................................................................................................................................... 9

6. 가구통계 API ..................................................................................................................................................... 13

7. 주택통계 API ..................................................................................................................................................... 15

8. 사업체통계 API ................................................................................................................................................. 18

9. 산업분류 API ..................................................................................................................................................... 21

10. 농가통계 API ................................................................................................................................................... 22

11. 임가통계 API ................................................................................................................................................... 25

12. 어가통계 API ................................................................................................................................................... 27

13. 가구원통계 API ............................................................................................................................................... 29

14. 연관어검색 API ............................................................................................................................................... 32

15. SOP검색 API ................................................................................................................................................... 33

16. KOSIS검색 API ................................................................................................................................................ 35

17. 생활업종 후보지검색 API .............................................................................................................................. 37

18. 거주인구요약정보 API ................................................................................................................................... 39

19. 성별인구비율 요약정보 API .......................................................................................................................... 42

20. 거처종류 요약정보 API.................................................................................................................................. 44

21. 점유형태 요약정보 API.................................................................................................................................. 46

22. 소상공인 업종별 사업체비율 API................................................................................................................. 47

23. 소상공인 업종별 사업체증감 API................................................................................................................. 49

24. 생활업종 후보지 정보 API ............................................................................................................................ 51

25. 시도별 생활업종 순위 API ............................................................................................................................ 53

26. 시도별 생활업종 정보 API ............................................................................................................................ 55

27. 시도별 생활업종 속성 API ............................................................................................................................ 56

28. 시군구별 생활업종 사업체수 API................................................................................................................. 58

29. 시군구별 생활업종 정보 API ........................................................................................................................ 60

30. 생활업종 시군구 순위 API ............................................................................................................................ 62

31. 생활업종 후보지 비교 API ............................................................................................................................ 64

32. 단계별 주소 조회 API ................................................................................................................................... 68

목 차

- 3 -

OpenAPI 정의서



33. 지오코딩 API ................................................................................................................................................... 70

34. 리버스 지오코딩 API ..................................................................................................................................... 73

35. 행정구역 경계 API ......................................................................................................................................... 75

36. 집계구 경계 API ............................................................................................................................................. 78

37. 영역내 경계 API ............................................................................................................................................. 80

38. 임의 영역내 전개도 건물정보 API ............................................................................................................... 82

39. 건물 층정보 API ............................................................................................................................................. 84

40. 층별 최외각 공간속성 API ............................................................................................................................ 85

41. 층별 사업체 공간속성 API ............................................................................................................................ 87

42. 층별 시설물 공간속성 API ............................................................................................................................ 89

43. 건물층별 사업체 정보 API ............................................................................................................................ 91

44. 지역현안 소통지도 목록 API ........................................................................................................................ 93

45. 지역현안 소통지도 상세 API ........................................................................................................................ 95

46. 전국 기술업종 정보 API ................................................................................................................................ 97

47. 시도별 기술업종 정보 API ............................................................................................................................ 99

48. 시군구별 기술업종 정보 API ...................................................................................................................... 100

49. 소지역 코드찾기 API ................................................................................................................................... 103

- 4 -

OpenAPI 정의서



서비스 명세

1. 인증 API

서비스 명세

서비스

정보

서비스명 인증 API

서비스 설명 발급된 인증키를 통한 인증단계를 처리하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/auth/authentication.json

※ 통계청 포털 (http://sgis.kostat.go.kr), 통계청 개발자지원센터 (http://sgis.kostat.go.kr/developer)

요청 메시지 명세

항목명(영문) 값 항목구분 항목설명

consumer_key String 1 서비스 ID

consumer_secret String 1 서비스 Secret

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

응답 메시지 명세


accessToken String 1 OAuth 인증키 API 호출 시 사용

accessTimeout Object 1 1970년 1월1일 0시부터 현재까지의 초


응답 에러코드

응답코드(결과코드) 설명

0 정상

-401 필수파라미터 누락

-100 검색결과 없음

2. Javascript 제공 API

서비스 명세

서비스

정보

서비스명 Javascript 제공 API

서비스 설명 JavaScript API를 제공하기위한 인증 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/auth/javascriptAuth.json


http://sgis.kostat.go.kr/

http://sgis.kostat.go.kr/developer



- 5 -

OpenAPI 정의서





consumer_key String 1 서비스 ID




Javascript API String 1 자바스크립트 전송


3. 좌표변환 API

서비스 명세

서비스

정보

서비스명 좌표변환 API

서비스 설명 좌표변환을 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/transformation/transcoord.json




accessToken String 1 액세스토큰

src String 1 현재 좌표체계

dst String 1 변환할 좌표체계

posX String 1 X값

posY String 1 Y값




toSrs String 1 변환된 좌표체계

posX String 1 변환된좌표 X값

posY String 1 변환된좌표 Y값




- 6 -

OpenAPI 정의서



요청 / 응답 메시지 예제

응답 메시지

{

"id": "API_0201",

"result": {

"posY": 1816238.1323095055,

"posX": 990391.6062050104

},

"errMsg": "Success",

"errCd": 0,

"trId": "c*Et_API_0201_1496643782285"

}

좌표체계코드

순번 좌표계 코드 순번 좌표계 코드

1 BESSEL 경/위도 EPSG:4004, EPSG:4162 6 제주원점(GRS80) EPSG:5182

2 WGS84 경/위도 EPSG:4326, EPSG:4166 7 동부원점(GRS80) EPSG:5183, EPSG:5187

3 GRS80 경/위도 EPSG:4019 8 동해(울릉)원점(GRS80) EPSG:5184, EPSG:5188

4 서부원점(GRS80) EPSG:5185, EPSG:5180 9 UTM-K (GRS80) EPSG:5179

5 중부원점(GRS80) EPSG:5181, EPSG:5186 10 Google Mercator EPSG:900913

응답 에러코드


0 정상



4. 총조사 주요지표 API

서비스 명세

서비스

정보

서비스명 총조사 주요지표 API

서비스 설명 인구주택총조사 정보중 전체적인 인구 통계 정보를 조회하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/population.json




- 7 -

OpenAPI 정의서






year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

adm_cd

non : 전국 시도 리스

트

2자리 : 해당 시도

5자리 : 해당 시군구

7자리 : 해당 읍면동

0 행정구역코드

low_search

행정구역코드에 해당

하는 정보만 요청 : 0

1단계 하위 행정구역

정보 요청 : 1


정보 요청 : 2

(default : 1)

0 하위 통계 정보 유무

bnd_year 2000 ~ 2015

(default : 2015) 0 경계데이터 연도




adm_cd String 1 행정구역코드

adm_nm String 1

행정구역명

* 집계구에서는 나오지 않음

tot_ppltn String 1 총인구

avg_age String 1 평균나이(세)

ppltn_dnsty String 1 인구밀도(명/㎢)

aged_child_idx String 1 노령화지수(일백명당 명)

oldage_suprt_per String 1 노년부양비(일백명당 명)

juv_suprt_per String 1 유년부양비(일백명당 명)

tot_family String 1 총가구

avg_fmember_cnt String 1 평균가구원수

- 8 -

OpenAPI 정의서



tot_house String 1 총주택

nongga_cnt String 1 농가(가구)

nongga_ppltn String 1 농가 인구

imga_cnt String 1 임가(가구)

imga_ppltn String 1 임가 인구

naesuoga_cnt String 1 내수면 어가(가구)

naesuoga_ppltn String 1 내수면 어가 인구

haesuoga_cnt String 1 해수면 어가(가구)

haesuoga_ppltn String 1 해수면 어가인구

employee_cnt String 1 종업원수(전체 사업체)

corp_cnt String 1 사업체수(전체 사업체)



응답 메시지

{

"id": "API_0301",

"result": [

{

"imga_ppltn": "N/A",

"adm_cd": "1104052",

"tot_house": "4165",

"ppltn_dnsty": "41739.4",

"tot_ppltn": "17658",

"aged_child_idx": "70",

"corp_cnt": "650",

"imga_cnt": "N/A",

"employee_cnt": "2151",

"haesuoga_cnt": "N/A",

"juv_suprt_per": "19.1",

"haesuoga_ppltn": "N/A",

"tot_family": "6343",

"adm_nm": "왕십리2동",

"nongga_cnt": "N/A",

"naesuoga_ppltn": "N/A",

"avg_age": "37.7",

- 9 -

OpenAPI 정의서



"avg_fmember_cnt": "2.8",

"nongga_ppltn": "19",

"naesuoga_cnt": "N/A",

"oldage_suprt_per": "13.3"

}

],


"errCd": 0,

"trId": "DUmk_API_0301_1496648537644"

}

응답 에러코드


0 정상



5. 인구통계 조건검색 API

서비스 명세

서비스

정보

서비스명 인구통계 조건검색 API

서비스 설명 인구주택총조사의 인구 통계를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/searchpopulation.json





year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

gender

0 : 전체

1 : 남자

2 : 여자

(default : 0)

0 성별



- 10 -

OpenAPI 정의서



adm_cd


트





low_search




정보 요청 : 1


정보 요청 : 2

(default : 1)


age_type 연령타입코드표참조 0 연령타입

edu_level 교육정도코드표참조 0

교육정도

* 2010년까지 제공, 2015연도는 제공하지 않

음

mrg_state

1 : 미혼

2 : 배우자 있음

3 : 사별

4 : 이혼

5 : 미상

0 혼인상태

* 2010년까지 제공, 2015연도는 제공하지 않음

bnd_year 2000 ~ 2015






adm_nm String 1

행정구역명


population String 1 인구수

avg_age String 1 평균나이(세)



응답 메시지

- 11 -

OpenAPI 정의서



{

{

"id": "API_0312",

"result": [

{

"adm_cd": "1104052",


"avg_age": "18",

"population": "N/A"

},

{

"adm_cd": "1104054",

"adm_nm": "마장동",

"avg_age": "18",

"population": "N/A"

},

{

"adm_cd": "1104067",

"adm_nm": "성수2가1동",

"avg_age": "17",

"population": "N/A"

},

{

"adm_cd": "1104068",

"adm_nm": "성수2가3동",

"avg_age": "19",

"population": "N/A"

}

],


"errCd": 0,

"trId": "Kv=5_API_0312_1496649957117"

}

교육정도코드

순번 단계 코드 순번 단계 코드

1 미상 0 6 전문학사 5

- 12 -

OpenAPI 정의서



2 수학없음(미취학포함) 1 7 학사 6

3 초등학교 2 8 석사 7

4 중학교 3 9 박사 8

5 고등학교 4

연령타입(age_type)


1 0~4세 01 22 15세미만 22

2 5~9세 02 23 15~64세 23

3 10~14세 03 24 65세이상 24

4 15~19세 04 25 85세이상 25

5 20~24세 05 26 유아(0~7세) 26

6 25~29세 06 27 초(8~13세) 27

7 30~34세 07 28 중(14~16세) 28

8 35~39세 08 29 고(`7~19세) 29

9 40~44세 09 30 10대이하 30

10 45~49세 10 31 10대 31

11 50~54세 11 32 20대 32

12 55~59세 12 33 30대 33

13 60~64세 13 34 40대 34

14 65~69세 14 35 50대 35

15 70~74세 15 36 60대 36

16 75~79세 16 37 70대 37

17 80~84세 17 38 80대 38

18 85~89세 18 39 90대 39

19 90~94세 19 40 70대이상 40

20 95~99세 20 41 80대이상 41

21 100세이상 21

응답 에러코드


0 정상



- 13 -

OpenAPI 정의서



6. 가구통계 API

서비스 명세

서비스

정보

서비스명 가구통계 API

서비스 설명 인구주택총조사의 가구 통계를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/household.json





year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

adm_cd


트





"영역검색유무"가 행정구역일 경우

low_search




정보 요청 : 1


정보 요청 : 2

(default : 1)



household_type 세대구성코드표 참고 0 세대구성별

다중선택 시 1,2,3 형태로 작성

ocptn_type 점유형태코드 참고 0

점유형태

다중선택 시 1,2,3 형태로 작성


음

bnd_year 2000 ~ 2015 0 경계데이터 연도



- 14 -

OpenAPI 정의서



(default : 2015)





adm_nm String 1 행정구역명


household_cnt String 1 가구수

family_member_cnt String 1 총 가구원 수

avg_family_member_cnt String 1 평균가구원수



응답 메시지

{

"id": "API_0305",

"result": [

{

"family_member_cnt": 1933,

"adm_cd": "1104052",


"avg_family_member_cnt": "18",

"household_cnt": "942"

}

],


"errCd": 0,

"trId": "xI3J_API_0305_1496652414411"

}

세대구성코드


1 1세대가구 01 5 5세대이상가구 05

2 2세대가구 02 6 1인가구 A0

3 3세대가구 03 7 비혈연가구 B0

- 15 -

OpenAPI 정의서



4 4세대가구 04

점유유형코드


1 자기집 1 4 보증금 없는 월세 4

2 전세(월세없음) 2 5 사글세 5

3 보증금 있는 월세 3 6 무상(관사,사택,친척집

등) 6

응답 에러코드


0 정상



7. 주택통계 API

서비스 명세

서비스

정보

서비스명 주택통계 API

서비스 설명 인구주택총조사의 주택에 대한 통계정보 검색기능을 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/house.json





year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

adm_cd


트








- 16 -

OpenAPI 정의서



low_search




정보 요청 : 1


정보 요청 : 2

(default : 1)



house_type 주택유형코드 참고 0 주택유형

const_year 건축연도코드 참고 0

건축연도(from)


음

* 주택사용기간과 동시에 사용할 수 없음

bnd_year 2000 ~ 2015


house_area_cd 주택면적코드 참고 0 주택면적코드

house_use_prid_cd 주택사용기간코드 참

고 0

노후년수코드

* 2015년만 제공

* 건축연도와 동시에 사용할 수 없음







house_cnt String 1 주택수(호)



응답 메시지

{

"id": "API_0306",

"result": [

{

"house_cnt": "N/A",

"adm_cd": "25010",

- 17 -

OpenAPI 정의서



"adm_nm": "동구"

},

{

"house_cnt": "N/A",

"adm_cd": "25030",

"adm_nm": "서구"

},

{

"house_cnt": "N/A",

"adm_cd": "25040",

"adm_nm": "유성구"

}

],


"errCd": 0,

"trId": "NR=N_API_0306_1496653470934"

}

주택유형코드


1 단독주택 01 4 다세대주택 04

2 아파트 02 5 비거주용 건물(상가, 공

장, 여관 등)내 주택 05

3 연립주택 03 6 주택이외의 거처 06

건축연도코드(2010년 이하)


1 2010년 01 8 1995년~1999년 08

2 2009년 02 9 1990년~1994년 09

3 2008년 03 10 1980년~19989년 10

4 2007년 04 11 1970년~1979년 11

5 2006년 05 12 1960년~1969년 12

6 2005년 06 13 1959년 이전 13

7 2000년~2004년 07

- 18 -

OpenAPI 정의서



노후년수(2015년 이상)


1 1년 미만 01 8 10년~15년 미만 07

2 1년~2년 미만 02 9 15년~20년 미만 08

3 2년~3년 미만 03 10 20년~30년 미만 09

4 3년~4년 미만 04 11 30년~40년 미만 10

5 4년~5년 미만 05 12 40년~50년 미만 11

6 5년~10년 미만 06 13 50년 이상 12

연면적


1 20㎡ 이하 01 6 100㎡~130㎡ 이하 06

2 20㎡~40㎡ 이하 02 7 130㎡~165㎡ 이하 07

3 40㎡~60㎡ 이하 03 8 165㎡~230㎡ 이하 08

4 60㎡~85㎡ 이하 04 9 230㎡ 초과 09

5 85㎡~100㎡ 이하 05

응답 에러코드


0 정상



8. 사업체통계 API

서비스 명세

서비스

정보

서비스명 사업체통계 API

서비스 설명 인구주택총조사 정보 중 사업체 통계를 조회하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/company.json





year 2000년 : 2000 1 기준연도



- 19 -

OpenAPI 정의서



2005년 : 2005

2010년 : 2010

2015년 : 2015

adm_cd


트






low_search




정보 요청 : 1


정보 요청 : 2

(default : 1)



class_code "산업분류 API"의 조

회 항목 0

산업분류코드

테마코드, 산업체코드는 같이 사용할 수 없

음

theme_cd 테마코드표 참고 0

테마코드

테마코드, 산업체코드는 같이 사용할 수 없

음

bnd_year 2000 ~ 2014



※ 테마코드표 참고 : https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/ThemeCode.html

※ adm_cd항목 링크정보 : 아래 링크에서 내용부분을 선택하면 엑셀로 다운로드

https://sgis.kostat.go.kr/view/board/faqView?post_no=13&board_cd=BOARD_002

※ class_code 항목 링크정보 : 아래 링크에서 hwp 다운로드

8차 : https://sgis.kostat.go.kr/developer/upload/doc/8차산업분류(2000-2005).hwp

9차 : https://sgis.kostat.go.kr/developer/upload/doc/9차산업분류(2006-2014).xls






https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/ThemeCode.html

https://sgis.kostat.go.kr/view/board/faqView?post_no=13&board_cd=BOARD_002

https://sgis.kostat.go.kr/developer/upload/doc/8차산업분류(2000-2005).hwp

https://sgis.kostat.go.kr/developer/upload/doc/9차산업분류(2006-2014).xls

- 20 -

OpenAPI 정의서



corp_cnt String 1 사업체수(개)

tot_worker String 1 종사자수(명)



응답 메시지

{

"id": "API_0304",

"result": [

{

"adm_cd": "2503060060001",

"corp_cnt": "N/A",

"tot_worker": "128"

},

{

"adm_cd": "2503060120001",

"corp_cnt": "N/A",

"tot_worker": "23"

}

],


"errCd": 0,

"trId": "aJ*o_API_0304_1496801707866"

}

주택유형코드


1 단독주택 01 4 다세대주택 04

2 아파트 02 5 비거주용 건물(상가, 공

장, 여관 등)내 주택 05

3 연립주택 03 6 주택이외의 거처 06

응답 에러코드


0 정상


- 21 -

OpenAPI 정의서




9. 산업분류 API

서비스 명세

서비스

정보

서비스명 산업분류 API

서비스 설명 인구주택총조사의 산업분류 코드를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/industrycode.json





class_code String 1

산업분류코드 조회의 기준이 되는 분류코드

변수, 이 변수를 기준으로 하위 분류코드의

리스트가반환되며, null인 경우 최상위

분류코드 리스트 반환

최대 6자리(5단계) 1-2-1-1-1자리로 구성




class_code String 1 산업분류 코드

class_nm String 1 산업분류 코드명



응답 메시지

{

"id": "API_0303",

"result": [

{

"class_code": "A011",

"class_nm": "작물 재배업"

},



- 22 -

OpenAPI 정의서



{


"class_nm": "축산업"

},

{


"class_nm": "작물재배 및 축산 복합농업"

},

{


"class_nm": "작물재배 및 축산 관련 서비스업"

},

{


"class_nm": "수렵 및 관련 서비스업"

}

],


"errCd": 0,

}

응답 에러코드


0 정상



10. 농가통계 API

서비스 명세

서비스

정보

서비스명 농가통계 API

서비스 설명 농림어업총조사의 농가 통계를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/farmhousehold.json




- 23 -

OpenAPI 정의서






year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

adm_cd


트






low_search



하위 행정구역 정보

요청 : 1

(default : 0)



bnd_year 2000 ~ 2015








farm_cnt String 1 단위 : 가구

농가 수

population String 1 단위 : 명

농가인구 수

avg_population String 1 단위 : 명

농가 평균 인구 수



응답 메시지

- 24 -

OpenAPI 정의서



{

"id": "API_0307",

"result": [

{

"adm_cd": "25010",

"farm_cnt": "1293",

"adm_nm": "동구",

"avg_population": "3",

"population": "3935"

},

{

"adm_cd": "25020",

"farm_cnt": "1074",

"adm_nm": "중구",



},

{

"adm_cd": "25050",

"farm_cnt": "1289",

"adm_nm": "대덕구",



}

],


"errCd": 0,

"trId": "EvTq_API_0307_1496804627540"

}

응답 에러코드


0 정상



- 25 -

OpenAPI 정의서



11. 임가통계 API

서비스 명세

서비스

정보

서비스명 임가통계 API

서비스 설명 농림어업총조사의 임가가 통계를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/forestryhousehold.json





year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

adm_cd


트






low_search




요청 : 1

(default : 0)



bnd_year 2000 ~ 2015










- 26 -

OpenAPI 정의서



forestry_cnt String 1 임가수(가구)

population String 1 임가인구수(명)

avg_population String 1 임가평균인구수(명)



응답 메시지

{

"id": "API_0308",

"result": [

{

"adm_cd": "25010",

"adm_nm": "동구",

"forestry_cnt": "64",


"population": "208"

},

{

"adm_cd": "25020",

"adm_nm": "중구",



"population": "170"

},

{

"adm_cd": "25050",




"population": "314"

}

],


"errCd": 0,

"trId": "1hO9_API_0308_1496804819462"

}

- 27 -

OpenAPI 정의서



응답 에러코드


0 정상



12. 어가통계 API

서비스 명세

서비스

정보

서비스명 어가통계 API

서비스 설명 농림어업총조사의 (해수면, 내수면)어가 통계를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/fisheryhousehold.json





year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

oga_div

전체 : 0

내수면어가 : 1

해수면어가 : 2

1 어가구분

adm_cd


트






low_search




요청 : 1

(default : 0)





- 28 -

OpenAPI 정의서



bnd_year 2000 ~ 2015








fishery_cnt String 1 단위 : 가구

어가 수

population String 1 단위 : 명

어가인구 수

avg_population String 1 단위 : 명

어가 평균 인구 수



응답 메시지

{

"id": "API_0309",

"result": [

{

"adm_cd": "25010",

"fishery_cnt": "N/A",

"adm_nm": "동구",


"population": "N/A"

},

{

"adm_cd": "25020",


"adm_nm": "중구",


"population": "9"

},

- 29 -

OpenAPI 정의서



{

"adm_cd": "25050",




"population": "6"

}

],


"errCd": 0,

"trId": "UXgB_API_0309_1496805115923"

}

응답 에러코드


0 정상



13. 가구원통계 API

서비스 명세

서비스

정보

서비스명 가구원통계 API

서비스 설명 농림어업총조사의 농가, 임가, 어가의 가구원 통계를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/stats/householdmember.json





year

2000년 : 2000

2005년 : 2005

2010년 : 2010

2015년 : 2015

1 기준연도

data_type 농가 : 1 1 가구타입



- 30 -

OpenAPI 정의서



임가 : 2

해수면어가 : 3

내수면어가 : 4

adm_cd


트






low_search




요청 : 1

(default : 0)



gender

총합 : 1

남자 : 2

여자 : 3

0 성별

age_from 0 ~ 150 0 나이(from)

age_to 0 ~ 150 0 나이(to)

bnd_year 2000 ~ 2015

(default : 2015) 0

경계데이터 연도







population String 1 가구원수(명)



응답 메시지

{

"id": "API_0310",

"result": [

- 31 -

OpenAPI 정의서



{

"adm_cd": "25010",

"adm_nm": "동구",

"population": "80"

},

{

"adm_cd": "25020",

"adm_nm": "중구",

"population": "67"

},

{

"adm_cd": "25040",

"adm_nm": "유성구",

"population": "225"

},

{

"adm_cd": "25050",


"population": "113"

}

],


"errCd": 0,

"trId": "F9Qi_API_0310_1496805504505"

}

응답 에러코드


0 정상



- 32 -

OpenAPI 정의서



14. 연관어검색 API

서비스 명세

서비스

정보

서비스명 연관어검색 API

서비스 설명 사용자가 요청한 검색어를 통하여 연관어 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/search/relword.json





searchword String 1 검색어




rel_search_word String 1 유의어



응답 메시지

{

"id": "API_0501",

"result": [

{

"rel_search_word": "내집마련"

}

],


"errCd": 0,

"trId": "7Yw=_API_0501_1496805793957"

}



- 33 -

OpenAPI 정의서



응답 에러코드


0 정상



15. SOP검색 API

서비스 명세

서비스

정보

서비스명 SOP검색 API

서비스 설명 사용자가 요청한 검색어를 통하여 SOP 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/search/sop.json






pagenum String 0 검색페이지

resultcount min : 1, max : 50

(default : 5) 0 현재 페이지 검색결과 수




totalcount String 1 전체 데이터 수

pagenum String 1 현재 페이지 넘버

returncount String 1 현재 페이지 결과 수

resultData List 1 결과정보

ㄴstat_id String 1 통계ID

ㄴdata_base_year String 1 데이터연도

ㄴnm String 1 명칭

ㄴurl String 1 URL




- 34 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0502",

"result": {

"totalcount": "2",

"resultdata": [

{

"stat_id": 43215,

"data_base_year": "2015",

"url":

"/view/map/interactiveMap/house?params=area_type%3D0%26low_search%3D1%26year%3D2015",

"nm": "총 주택수 (인구주택총조사)"

},

{

"stat_id": 835,

"data_base_year": "2010",

"url":

"/view/map/interactiveMap/house?params=area_type%3D0%26low_search%3D1%26year%3D2010",

"nm": "총 주택수 (인구주택총조사)"

}

],

"pagenum": 0,

"resultcount": 2

},


"errCd": 0,

"trId": "sxZB_API_0502_1496816256487"

}

응답 에러코드


0 정상



- 35 -

OpenAPI 정의서



16. KOSIS검색 API

서비스 명세

서비스

정보

서비스명 KOSIS검색 API

서비스 설명 사용자가 요청한 검색어를 통하여 행정구역통계검색 정보를 제공하기 위한

API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/search/kosis.json






pagenum String 0 검색페이지


(default : 5) 0 현재 페이지 검색결과 수







resultData List 1 결과정보

ㄴ kosis_inst_nm String 1 자료제공기관명

ㄴ kosis_menu_id String 1 메뉴ID

ㄴ kosis_menu_nm String 1 항목명

ㄴ kosis_inst_cd String 1 자료제공기관코드

ㄴ menu_path String 1 메뉴패스정보

ㄴ administzone_item_cd String 1 행정구역항목코드

ㄴ atdrc_yn String 1

비자치구여부

0 : 자치구

1 : 비자치구

ㄴ gis_se String 1 자료제공범위 1 : 시도 2 : 시군구 3 : 읍면동

ㄴ field_id String 1 필드ID




- 36 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0503",

"result": {

"totalcount": "74",

"resultdata": [

{

"kosis_inst_nm": "통계청",

"kosis_menu_id": "DT_1INOO01",

"kosis_menu_nm": "행정구역별 총조사인구,가구 및 주택",

"kosis_inst_cd": "101",

"menu_path": "인구·가구>인구총조사>인구부문>총조사인구(2000)>전수부문",

"administzone_item_cd": "A",

"atdrc_yn": "0",

"gis_se": "3",

"field_id": "OV_L1_ID"

}

],

"pagenum": "0",

"returncount": "5"

},


"errCd": 0,

"trId": "Oslt_API_0503_1496816696443"

}

응답 에러코드


0 정상



- 37 -

OpenAPI 정의서



17. 생활업종 후보지검색 API

서비스 명세

서비스

정보

서비스명 생활업종 후보지검색 API

서비스 설명 지역 내 생활업종 후보지검색을 조회하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/startupbiz.json





adm_cd 2자리 : 해당 시도

5자리 : 해당 시군구 1 행정동 코드

ppl_type 1 : 거주인구

2 : 직장인구 0 인구유형

ppl_val

1 : 적은지역

2 : 평균지역

3 : 많은지역

0 거주인구범위

*직장인구와 동시에 사용할 수 없음

ppl_gender_type 1: 남자

2: 여자 0

성별인구타입

*성별인구범위와 동시에 사용


ppl_gender_val

1 : 적은지역

2 : 평균지역

3 : 많은지역

0

성별인구타입

*성별인구범위와 동시에 사용


ppl_age_type 연령코드표 참고 0

연령별인구타입

*연령별인구범위와 동시에 사용


ppl_age_val

1 : 적은지역

2 : 평균지역

3 : 많은지역

0

연령별인구타입

*연령별인구범위와 동시에 사용




- 38 -

OpenAPI 정의서



family_type 가구유형코드표 참고 0 가구유형타입

*가구지역범위와 동시에 사용

family_val

1 : 적은지역

2 : 평균지역

3 : 많은지역

0 가구유형타입

*가구지역범위와 동시에 사용

house_type 주택코드표 참고 0 거주주택유형타입

*거주주택범위와 동시에 사용

house_val

1 : 적은지역

2 : 평균지역

3 : 많은지역

0 거주주택유형타입

*거주주택범위와 동시에 사용

house_old_val

1 : 적은지역

2 : 평균지역

3 : 많은지역

0

노후주택(20년이상)범위

*거주주택유형타입과 동시에 사용

apartprice

1 : 적은지역

2 : 평균지역

3 : 많은지역

0 공시지가

theme_cd 테마코드표 참고 0 사업체종류

corp_cnt

1 : 적은지역

2 : 평균지역

3 : 많은지역

0 업종별 사업체 수

rate_change

1 : 적은지역

2 : 평균지역

3 : 많은지역

0 업종별 사업체 증감


※ 연령코드표 참조 : https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/PplAgeCode.html

※ 가구유형코드표 참조 :

https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/FamilyTypeCode.html

※ 주택코드표 참조 : https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/HouseCode.html

※ 테마코드표 참조 : https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/ThemeCode.html



adm_cd String 1 행정구역 코드

adm_nm String 1 행정구역 이름


https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/PplAgeCode.html


https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/HouseCode.html


- 39 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0601",

"result": [

{

"adm_cd": "25020",

"adm_nm": "중구"

},

{

"adm_cd": "25010",

"adm_nm": "동구"

},

{

"adm_cd": "25040",

"adm_nm": "유성구"

}

],


"errCd": 0,

"trId": "BQxF_API_0601_1496826467253"

}

응답 에러코드


0 정상



18. 거주인구요약정보 API

서비스 명세

서비스

정보

서비스명 거주인구요약정보 API

서비스 설명 행정구역 내 거주인구 요약정보를 제공하기 위한 API

- 40 -

OpenAPI 정의서



요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/pplsummary.json





adm_cd 5자리 : 시군구

7자리 : 읍면동 1 행정구역 코드






teenage_less_than_per 소수점 두

자리 1 10대 미만 인구비율

teenage_less_than_cnt String 1 10대 미만 인구수

teenage_per 소수점두

자리 1 10대 인구비율

teenage_cnt String 1 10대 인구수

twenty_per 소수점두


twenty_cnt String 1 20대 인구수

thirty_per 소수점두


thirty_cnt String 1 30대 인구수

forty_per 소수점두


forty_cnt String 1 40대 인구수

fifty_per 소수점두

자리 1

50대 인구비율

fifty_cnt String 1 50대 인구수

sixty_per 소수점두


sixty_cnt String 1 60대 인구수

seventy_more_than_per 소수점두 1 70대 이상 인구비율



- 41 -

OpenAPI 정의서



자리

seventy_more_than_cnt String 1 70대 이상 인구수



응답 메시지

{

"id": "API_0602",

"result": [

{

"adm_cd": "25040",

"forty_per": "17.96",

"seventy_more_than_cnt": "15934",

"fifty_cnt": "46800",

"seventy_more_than_per": "4.7",

"teenage_per": "13.51",

"twenty_per": "15.42",

"thirty_cnt": "57046",

"sixty_cnt": "20563",

"teenage_less_than_per": "11.73",

"thirty_per": "16.82",

"teenage_less_than_cnt": "39808",


"forty_cnt": "60944",

"twenty_cnt": "52319",

"sixty_per": "6.06",

"fifty_per": "13.8",

"teenage_cnt": "45828"

}

],


"errCd": 0,

"trId": "QQK2_API_0602_1496892496085"

}

- 42 -

OpenAPI 정의서



응답 에러코드


0 정상



19. 성별인구비율 요약정보 API

서비스 명세

서비스

정보

서비스명 성별인구비율 요약정보 API

서비스 설명 행정구역 내 성별인구비율 요약정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/mfratiosummary.json












f_per 소수점두

자리 1 여자비율

m_per 소수점두

자리 1 남자비율

f_ppl String 1 여자인구

m_ppl String 1 남자인구

total_ppl String 1 전체인구




- 43 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0603",

"result": [

{

"adm_cd": "25040",

"f_ppl": "166276",


"m_ppl": "172966",

"m_per": "50.99",

"f_per": "49.01",

"total_ppl": "339242"

},

{

"adm_cd": "25",

"f_ppl": "754897",

"adm_nm": "대전광역시",

"m_ppl": "744623",

"m_per": "49.66",

"f_per": "50.34",

"total_ppl": "1499520"

}

],


"errCd": 0,

"trId": "KKr5_API_0603_1496897892830"

}

응답 에러코드


0 정상



- 44 -

OpenAPI 정의서



20. 거처종류 요약정보 API

서비스 명세

서비스

정보

서비스명 거처종류 요약정보 API

서비스 설명 행정구역 내 거처종류 요약정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/housesummary.json












dom_soc_fac_cnt String 1 기숙사 및 사회시설-수

apart_per String 1 아파트 - 비율

row_house_per String 1 연립/다세대 - 비율

officetel_cnt String 1 오피스텔-수

officetel_per String 1 오피스텔-비율

apart_cnt String 1 아파트-수

detach_house_cnt String 1 단독주택-수

etc_cnt String 1 기타-수

effi_apart_per String 1 오피스텔 - 비율

detach_house_per String 1 단독주택 - 비율

row_house_cnt String 1 연립/다세대-수

dom_soc_fac_per String 1 기숙사 및 사회시설 - 비율

etc_per String 1 기타 - 비율




- 45 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0604",

"result": [

{

"adm_cd": "25040",

"dom_soc_fac_cnt": 261,

"row_house_cnt": 3872,

"officetel_per": "2.13",

"apart_cnt": 81839,

"dom_soc_fac_per": "0.21",


"detach_house_cnt": 34630,

"etc_per": "2.4",

"etc_cnt": 3029,

"officetel_cnt": 2694,

"detach_house_per": "27.41",

"apart_per": "64.78",

"row_house_per": "3.07"

}

],


"errCd": 0,

"trId": "FqfD_API_0604_1496900476507"

}

응답 에러코드


0 정상



- 46 -

OpenAPI 정의서



21. 점유형태 요약정보 API

서비스 명세

서비스

정보

서비스명 점유형태 요약정보 API

서비스 설명 행정구역 내 점유형태 요약정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/ocptnsummary.json












self_per 소수점두

자리 1 자가비율

lease_per 소수점두

자리 1 전세비율

mrp_per 소수점두

자리 1 월세비율



응답 메시지

{

"id": "API_0606",

"result": [

{

"adm_cd": "25040",



- 47 -

OpenAPI 정의서




"mrp_per": "24.78",

"lease_per": "18.34",

"self_per": "49.45"

},

{

"adm_cd": "25",


"mrp_per": "23.64",

"lease_per": "15.43",

"self_per": "54.58"

}

],


"errCd": 0,

"trId": "U3UJ_API_0606_1496901408115"

}

응답 에러코드


0 정상



22. 소상공인 업종별 사업체비율 API

서비스 명세

서비스

정보

서비스명 소상공인 업종별 사업체비율 API

서비스 설명 행정구역 내 소상공인 업종별 사업체비율 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/corpdistsummary.json







- 48 -

OpenAPI 정의서










theme_list List 1 테마정보 리스트

ㄴ s_theme_cd_nm String 1 테마명(업종명)

ㄴ theme_cd String 1 테마코드(업종코드)

ㄴ dist_per String 1 분포-비율



응답 메시지

{

"id": "API_0607",

"result": [

{

"theme_list": [

{

"s_theme_cd_nm": "인테리어",

"theme_cd": "1001",

"dist_per": "4.33"

},

{

"s_theme_cd_nm": "목욕탕",

"theme_cd": "1002",

"dist_per": "0.74"

},

{

"s_theme_cd_nm": "교습학원",

"theme_cd": "1003",

"dist_per": "11.2"

}

- 49 -

OpenAPI 정의서



],

"adm_cd": "25",

"adm_nm": "대전광역시"

}

],


"errCd": 0,

"trId": "xpVv_API_0607_1496901941064"

}

응답 에러코드


0 정상



23. 소상공인 업종별 사업체증감 API

서비스 명세

서비스

정보

서비스명 소상공인 업종별 사업체증감 API

서비스 설명 행정구역 내 소상공인 업종별 사업체증감 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/corpindecrease.json











year String 1 연도



- 50 -

OpenAPI 정의서



theme_list List 1 테마정보 리스트

ㄴ theme_cd String 1 테마코드(업종코드)

ㄴ theme_nm String 1 테마명(업종명)

ㄴ corp_cnt String 1 사업체수



응답 메시지

{

"id": "API_0609",

"result": [

{

"theme_list": [

{

"theme_cd": "1001",

"corp_cnt": 63,

"theme_nm": "인테리어"

},

{

"theme_cd": "1002",

"corp_cnt": 8,

"theme_nm": "목욕탕"

},

{

"theme_cd": "9002",

"corp_cnt": 78,

"theme_nm": "은행"

}

],

"adm_cd": null,

"year": "2007"

}

],


"errCd": 0,

"trId": "yLWQ_API_0609_1496903074521"

- 51 -

OpenAPI 정의서



}

응답 에러코드


0 정상



24. 생활업종 후보지 정보 API

서비스 명세

서비스

정보

서비스명 생활업종 후보지 정보 API

서비스 설명 행정구역 내 지역종합정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/regiontotal.json












apart_per String 1 공시지가 비율

resid_ppltn_per String 1 거주인구 비율

job_ppltn_per String 1 직장인구 비율

one_person_family_per String 1 1인가구 비율

sixty_five_more_ppltn_per String 1 65세이상인구 비율

twenty_ppltn_per String 1 20대인구 비율




- 52 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0610",

"result": [

{

"twenty_ppltn_per": "5",

"one_person_family_per": "5",

"adm_cd": "25",


"resid_ppltn_per": "5",

"sixty_five_more_ppltn_per": "5",

"apart_per": "5",

"job_ppltn_per": "5"

},

{

"twenty_ppltn_per": "9",

"one_person_family_per": "5",

"adm_cd": "25040",


"resid_ppltn_per": "3",

"sixty_five_more_ppltn_per": "1",

"apart_per": "9",

"job_ppltn_per": "7"

}

],


"errCd": 0,

"trId": "RNaw_API_0610_1496904032302"

}

응답 에러코드


0 정상



- 53 -

OpenAPI 정의서



25. 시도별 생활업종 순위 API

서비스 명세

서비스

정보

서비스명 시도별 생활업종 순위 API

서비스 설명 시도별 생활업종 순위 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/sidotobrank.json





sido_cd 시도코드표 참고 1 시도 코드


※ 시도코드표 참조 : https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/SidoCode.html



sido_cd String 1 시도 코드

sido_nm String 1 시도명

tob_rank List 1 시도별 순위정보

ㄴ theme_cd String 1 테마코드

ㄴ theme_nm String 1 테마명

ㄴ corp_cnt_rank String 1 사업체수-순위


ㄴ corp_per_rank String 1 사업체비율-순위

ㄴ corp_per String 1 사업체비율

ㄴ corp_irds_rank String 1 사업체증감-순위

ㄴ corp_irdsrate String 1 사업체증감

ㄴ worker_cnt_rank String 1 종사자수-순위

ㄴ worker_cnt String 1 종사자수

ㄴ worker_per_rank String 1 종사자비율-순위

ㄴ worker_per String 1 종사자비율

ㄴ worker_irds_rank String 1 종사자증감-순위

ㄴ worker_irdsrate String 1 종사자증감




https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/SidoCode.html

- 54 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0612",

"result": {

"sido_nm": "대전광역시",

"tob_rank": [

{

"corp_cnt_rank": 16,

"theme_cd": "1001",

"corp_cnt": 740,

"corp_per_rank": 16,

"worker_per_rank": 14,

"worker_irdsrate": "26.1",

"corp_irds_rank": 6,

"worker_per": "2.1",

"worker_irds_rank": 2,

"worker_cnt": 2374,

"corp_irdsrate": "10.9",

"worker_cnt_rank": 14,

"corp_per": "1.6",

"theme_nm": "인테리어"

}

],

"sido_cd": "25"

},


"errCd": 0,

"trId": "J7Bo_API_0612_1496904957752"

}

응답 에러코드


0 정상


- 55 -

OpenAPI 정의서




26. 시도별 생활업종 정보 API

서비스 명세

서비스

정보

서비스명 시도별 생활업종 정보 API

서비스 설명 시도별 생활업종 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/sidotobinfo.json












rstrt_per String 1 음식점-비율

rstrt_corp_cnt String 1 음식점-사업체수

srv_per String 1 서비스-비율

srv_corp_cnt String 1 서비스-사업체수

whrtlsal_per String 1 도소매-비율

whrtlsal_corp_cnt String 1 도소매-사업체수

lodgebiz_per String 1 숙박-비율

lodgebiz_corp_cnt String 1 숙박-사업체수



응답 메시지

{

"id": "API_0611",




- 56 -

OpenAPI 정의서



"result": {

"srv_per": "29",

"rstrt_per": "39.2",


"lodgebiz_per": "1.7",

"whrtlsal_corp_cnt": 13791,

"srv_corp_cnt": 13306,

"rstrt_corp_cnt": 17964,

"whrtlsal_per": "30.1",

"sido_cd": "25",

"lodgebiz_corp_cnt": 775

},


"errCd": 0,

"trId": "m4mB_API_0611_1496911842027"

}

응답 에러코드


0 정상



27. 시도별 생활업종 속성 API

서비스 명세

서비스

정보

서비스명 시도별 생활업종 속성 API

서비스 설명 시도별 생활업종 속성 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/sidotobgroup.json








- 57 -

OpenAPI 정의서



theme_cd 테마코드표 참고 1 테마 코드



※ 테마코드표 참조 : http://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/ThemeCode.html





theme_cd String 1 대분류 테마코드

b_theme_cd_nm String 1 대분류 테마코드명

group_attribute LIST 1 LIST


ㄴ s_theme_cd_nm String 1 테마코드명

ㄴ corp_per_rank String 1 사업체비율-순위

ㄴ corp_per String 1 사업체비율

ㄴ corp_cnt_rank String 1 사업체수-순위




응답 메시지

{

"id": "API_0613",

"result": {

"group_attribute": [

{


"s_theme_cd_nm": "문구점",

"theme_cd": "2001",

"corp_cnt": 12364,


"corp_per": "2.8"

},

{



http://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/ThemeCode.html

- 58 -

OpenAPI 정의서



"s_theme_cd_nm": "서점",

"theme_cd": "2002",

"corp_cnt": 5169,


"corp_per": "1.2"

}

],

"theme_cd": "20",

"sido_nm": "전국",

"sido_cd": "00",

"b_theme_cd_nm": "도소매"

},


"errCd": 0,

"trId": "LsqP_API_0613_1496912787554"

} "errMsg": "Success",

"errCd": 0,

"trId": "m4mB_API_0611_1496911842027"

}

응답 에러코드


0 정상



28. 시군구별 생활업종 사업체수 API

서비스 명세

서비스

정보

서비스명 시군구별 생활업종 사업체수 API

서비스 설명 시군구별 생활업종 사업체수 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/sggtobcorpcount.json




- 59 -

OpenAPI 정의서













sgg_cd String 1 시군구코드

sgg_nm String 1 시군구명


theme_cd_nm String 1 대분류 테마코드명

x_coor String 1 시군구 X 좌표

y_coor String 1 시군구 y 좌표

corp_cnt String 1 업체수

upregion_vs_corp_per String 1 상위지역대비 업종비율

corp_vs_family_rate String 1 업체대비 가구수(가구수/업체수)

biz_worker_cnt String 1 업종 종사자수

avg_worker_rate String 1 평균종사자수(종사자수/업체수)

corp_vs_worker_rate String 1 업체대비 직장인구(직장인구/업체수)

corp_vs_ppltn_rate String 1 업체대비 거주인구(인구/업체수)



응답 메시지

{

"id": "API_0615",

"result": [

{

"y_coor": "1952715",

"sgg_cd": "010",

"theme_cd": "5001",

"sido_nm": "서울특별시",


- 60 -

OpenAPI 정의서



"corp_cnt": 2536,

"sgg_nm": "종로구",

"sido_cd": "11",

"upregion_vs_corp_per": "5.3",

"theme_cd_nm": "한식",

"corp_vs_family_rate": "24.3",

"x_coor": "954045",

"biz_worker_cnt": 9664,

"avg_worker_rate": "3.8",

"corp_vs_worker_rate": "3.8",

"corp_vs_ppltn_rate": "56.8"

}

],


"errCd": 0,

"trId": "qo74_API_0615_1496916647513"

}

응답 에러코드


0 정상



29. 시군구별 생활업종 정보 API

서비스 명세

서비스

정보

서비스명 시군구별 생활업종 정보 API

서비스 설명 시군구별 생활업종 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/sggtobinfo.json







- 61 -

OpenAPI 정의서



sgg_cd String 1 시군구 코드











theme_cd_nm String 1 대분류 테마코드명


y_coor String 1 시군구 y 좌표

corp_cnt String 1 업체수

upregion_vs_corp_per String 1 상위지역대비 업종비율

corp_vs_family_rate String 1 업체대비 가구수(가구수/업체수)

biz_worker_cnt String 1 업종 종사자수

avg_worker_rate String 1 평균종사자수(종사자수/업체수)

corp_vs_worker_rate String 1 업체대비 직장인구(직장인구/업체수)

corp_vs_ppltn_rate String 1 업체대비 거주인구(인구/업체수)



응답 메시지

{

"id": "API_0616",

"result": {

"sgg_cd": "030",

"theme_cd": "5001",


"corp_cnt": 2542,

"sgg_nm": "서구",

"sido_cd": "25",

"upregion_vs_corp_per": "28.2",


- 62 -

OpenAPI 정의서



"theme_cd_nm": "한식",





"corp_vs_ppltn_rate": "189.2"

},


"errCd": 0,

"trId": "thVy_API_0616_1496918285043"

}

응답 에러코드


0 정상



30. 생활업종 시군구 순위 API

서비스 명세

서비스

정보

서비스명 생활업종 시군구 순위 API

서비스 설명 생활업종별 시군구 순위 정보를 제공하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/sggtobrank.json














- 63 -

OpenAPI 정의서





theme_cd String 1 테마코드

b_theme_cd_nm String 1 대분류 테마코드명

s_theme_cd_nm String 1 소분류 테마코드명



sgg_info LIST 1 시군구 정보

ㄴ sgg_cd String 1 시군구코드

ㄴ sgg_nm String 1 시군구명


ㄴ upregion_vs_corp_per String 1 상위지역대비 업종비율

ㄴ corp_vs_ppltn_rate String 1 업체대비 거주인구(인구/업체수)

ㄴ corp_vs_worker_rate String 1 업체대비 직장인구(직장인구/업체수)

ㄴ corp_vs_family_rate String 1 업체대비 가구수(가구수/업체수)

ㄴ biz_worker_cnt String 1 업종종사자수

ㄴ avg_worker_rate String 1 평균종사자수(종사자수/업체수)



응답 메시지

{

"id": "API_0617",

"result": {

"sgg_info": [

{

"sgg_cd": "010",



"corp_cnt": 1464,

"corp_vs_ppltn_rate": "164.6",



"sgg_nm": "동구",

"upregion_vs_corp_per": "16.3"

}

- 64 -

OpenAPI 정의서



],

"s_theme_cd_nm": "한식",

"theme_cd": "5001",


"sido_cd": "25",

"b_theme_cd_nm": "음식점"

},


"errCd": 0,

"trId": "vm1f_API_0617_1496918946817"

}

응답 에러코드


0 정상



31. 생활업종 후보지 비교 API

서비스 명세

서비스

정보

서비스명 생활업종 후보지 비교 API

서비스 설명 지역별 종합정보를 비교하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/startupbiz/Compareregiontotal.json





first_adm_cd String 1 첫번째 행정동코드

(5자리 : 시군구, 7자리 : 읍면동)

second_adm_cd String 1 두번쨰 행정동코드


third_adm_cd String 1 세번쨰 행정동코드




- 65 -

OpenAPI 정의서



theme_cd 테마코드표 참고 테마 코드

corp_cnt String 1 업종별 사업장 수

(1: 적은지역, 2: 평균지역, 3: 많은지역)

rate_change String 1 업종별 사업체 수 증감


family_type 가구유형코드표 참고 가구유형

family_val String 1 가구유형 값


house_type 주택종류코드표 참고 주택종류

house_val String 1 거주주택 수 값


house_old_val String 1 노후주택 수 값


apartprice String 1 아파트시세정도


ppl_type String 1 인구유형

(1: 거주인구, 2: 직장인구)

ppl_val String 1 인구유형 값


ppl_gender_type String 1 성별인구

(1: 남성인구, 2: 여성인구)

ppl_gender_val String 1 성별인구 값


ppl_age_type 연령코드표 참고 인구연령(거주인구)

(다중선택 시 1,2,3 형태로 작성)

ppl_age_val String 1 인구연령 값



※ 가구유형코드표 참조 :


※ 테마코드표 참조 : https://sgis.kostat.go.kr/developer/html/openApi/api/dataCode/ThemeCode.html

※ 주택유형코드표 참조 :


※ 연령코드표 참조 :






- 66 -

OpenAPI 정의서





companyCount LIST 0 사업체정보

ㄴ selecttype String 1 선택타입

ㄴ resultdata LIST 1 결과정보

ㄴ adm_cd String 1 행정동코드

ㄴ adm_nm String 1 행정동명

ㄴ value String 1 데이터값

companyIncrease LIST 0 사업체증감정보






jobpeople LIST 0 직장인구정보






staypeople LIST 0 거주인구정보






genderpeople LIST 0 성별인구정보






agepeople LIST 0 연령별인구정보




- 67 -

OpenAPI 정의서





household LIST 0 가구유형정보






apartprice LIST 0 공시지가정보






oldhouse LIST 0 노후주택정보








응답 메시지

{

"id": "API_0618",

"result": {

"companyCount": [

{

"resultdata": [

{

"adm_cd": "25",


"value": 9005

},

{

- 68 -

OpenAPI 정의서



"adm_cd": "25010",

"adm_nm": "동구",

"value": 1464

},

{

"adm_cd": "25020",

"adm_nm": "중구",

"value": 1768

}

],

"selecttype": "한식"

}

]

},


"errCd": 0,

"trId": "HdQ4_API_0618_1496919601504"

}

응답 에러코드


0 정상



32. 단계별 주소 조회 API

서비스 명세

서비스

정보

서비스명 단계별 주소 조회 API

서비스 설명 행정구역 및 도로명 주소에 대해서 단계별로 조회하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/addr/stage.json






- 69 -

OpenAPI 정의서




cd

최대 5자리

non : 시도정보

2자리 : 시군구

5자리 : 읍면동

0 코드

pg_yn

경계 미포함 : 0

경계 포함 : 1

(default : 0)

0 경계포함유무




cd String 1 시도/시군구/읍면동

addr_name String 1 시도명/시군구명/읍면동명

full_addr String 1 전체주소

x_coor UTM-K 1 X좌표

y_coor UTM-K 1 Y좌표

pg String 1 경량화 경계



응답 메시지

{

"id": "API_0701",

"result": [

{

"y_coor": "1944217",

"full_addr": "서울특별시 송파구 가락1동",

"x_coor": "965142",

"addr_name": "가락1동",

"cd": "1124066"

},

{

"y_coor": "1944444",

"full_addr": "서울특별시 송파구 가락2동",

"x_coor": "966995",

- 70 -

OpenAPI 정의서



"addr_name": "가락2동",

"cd": "1124067"

}

],


"errCd": 0,

"trId": "zvSI_API_0701_1496972620013"

}

응답 에러코드


0 정상



33. 지오코딩 API

서비스 명세

서비스

정보

서비스명 지오코딩 API

서비스 설명 입력된 주소에 대한 위치를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/addr/geocode.json





address String 1 검색주소

pagenum default : 0 1 페이지


(default : 5) 1 결과 수







- 71 -

OpenAPI 정의서





matching String 1 완전/분완전매칭 여부

(0 : 불완전 매칭, 1: 완전매칭)

resultdata LIST 1 결과정보

ㄴ sido_nm String 1 시도명

ㄴ sido_cd String 1 시도코드(법정동)

ㄴ sgg_nm String 1 시군구명

ㄴ sgg_cd String 1 시군구코드(법정동)


ㄴ leg_nm String 1 법정동코드

ㄴ leg_cd String 1 읍면동코드

ㄴ ri_nm String 1 리명

구 법정동일 경우

ㄴ ri_cd String 1 리코드

ㄴ road_nm String 1 도로명

도로명 주소일 경우

ㄴ road_cd String 1 도로명코드

ㄴ road_nm_main_no String 1 건물-본번


ㄴ road_nm_sub_no String 1 건물-부번


ㄴ bd_main_nm String 1 건물본명

ㄴ bd_sub_nm String 1 건물부명

ㄴ jibun_main_no String 1 지번-본번

ㄴ jibun_sub_no String 1 지번-부번

ㄴ X UTM-K 1 X좌표

ㄴ Y UTM-K 1 Y좌표



응답 메시지

{

"id": "API_0702",

"result": {

"totalcount": "27",

- 72 -

OpenAPI 정의서



"resultdata": [

{

"ri_nm": "null",

"road_nm_sub_no": "0",

"sgg_cd": "110",

"adm_cd": "1111053",

"road_nm_main_no": "59",

"leg_cd": "11350102",

"road_nm": "마들로",

"bd_sub_nm": "16동",

"addr_type": "6",


"sgg_nm": "서울시노원구",

"sido_cd": "11",

"road_cd": "3109006",

"bd_main_nm": "월계미성아파트",

"adm_nm": "월계3동",

"jibun_main_no": "17",

"jibun_sub_no": "null",

"ri_cd": "1135010200",

"y": "1958219.12861638",

"leg_nm": "월계동",

"x": "961780.127834065"

}

],

"matching": "0",

"pagenum": "0",

"returncount": "5"

},


"errCd": 0,

"trId": "iJ2S_API_0702_1496975504745"

}

응답 에러코드


0 정상

- 73 -

OpenAPI 정의서





34. 리버스 지오코딩 API

서비스 명세

서비스

정보

서비스명 리버스 지오코딩 API

서비스 설명 입력된 좌표의 주소를 조회하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/addr/rgeocode.json





x_coor UTM-K 1 X좌표

y_coor UTM-K 1 Y좌표

addr_type

도로명 : 10

행정동(읍면동) : 20

행정동(지번함) : 21

(default : 10)

0 주소종류





sido_cd String 1 시도코드



emdong_nm String 0 읍면동명

행정동 요청시

emdong_cd String 0 읍면동코드

행정동 요청시

main_no String 0 지번-본번

행정동 지번 요청시

sub_no String 0 지번-부번



- 74 -

OpenAPI 정의서




adm_dr_cd String 0 행정동코드


road_nm String 0 도로명

도로명주소 요청시

road_cd String 0 도로명코드


bd_nm String 0 건물본명


sub_bd_nm String 0 건물부명


road_nm_main_no String 0 도로명-본번


road_nm_sub_no String 0 도로명-부번


full_addr String 0 Full 주소



응답 메시지

{

"id": "API_0703",

"result": [

{

"road_cd": "3005024",

"sgg_cd": "040",

"road_nm_main_no": "307",

"road_nm": "광나루로",

"full_addr": "서울특별시 성동구 광나루로 307",


"sgg_nm": "성동구",

"sido_cd": "11"

}

],


"errCd": 0,

- 75 -

OpenAPI 정의서



"trId": "YTnQ_API_0703_1496978054216"

}

응답 에러코드


0 정상



35. 행정구역 경계 API

서비스 명세

서비스

정보

서비스명 행정구역 경계 API

서비스 설명 행정구역 코드를 이용한 행정구역 경계 정보 제공 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/boundary/hadmarea.geojson





year 2000 ~ 2015 1 기준연도

adm_cd

하위 통계 여부 0일

경우


트




하위 통계 여부 1일

경우


트

2자리 : 해당 하위 시

군구




- 76 -

OpenAPI 정의서



5자리 : 해당 하위 읍

면동

7자리 : 해당 하위 집

계구

low_search




정보 요청 : 1


정보 요청 : 2

(default : 1)





features LIST 1 경계속성정보

ㄴ type String 1 경계속성타입

ㄴ geometry Object 1 경계정보

ㄴ type String 1 경계타입

ㄴ coordinates String 1 경계좌표

ㄴ properties Object 1 속성정보



ㄴ x String 1 X좌표

ㄴ y String 1 Y좌표



응답 메시지

{

"type": "FeatureCollection",

"id": "API_0704",


"errCd": 0,

"trId": "HiRQ_API_0704_1497238018763",

"features": [

- 77 -

OpenAPI 정의서



{

"type": "Feature",

"geometry": {

"type": "Polygon",

"coordinates": [

[

[

953806.7501162111,

1959087.7502142726

],

[

953794.6882019043,

1958997.1252142726

]

]

]

},

"properties": {

"adm_cd": "11230",

"adm_nm": "서울특별시 강남구",

"y": "1946544",

"x": "960003"

}

}

}

응답 에러코드


0 정상



- 78 -

OpenAPI 정의서



36. 집계구 경계 API

서비스 명세

서비스

정보

서비스명 집계구 경계 API

서비스 설명 행정동코드를 이용한 집계구 경계 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/boundary/statsarea.geojson





adm_cd 7자리 1 행정동코드
















응답 메시지

{


"id": "API_0705",




- 79 -

OpenAPI 정의서



"errCd": 0,

"trId": "h4QC_API_0705_1497238269487",

"features": [

{

"type": "Feature",

"geometry": {

"type": "Polygon",

"coordinates": [

[

[

953525.3628282876,

1948833.4947620016

],

[

953525.5535282877,

1948832.4821620015

]

]

]

},

"properties": {

"adm_cd": "1103073040101",

"adm_nm": "서울특별시 용산구 한강로동"

}

}

]

}

응답 에러코드


0 정상



- 80 -

OpenAPI 정의서



37. 영역내 경계 API

서비스 명세

서비스

정보

서비스명 영역내 경계 API

서비스 설명 Boundary 경계내에 포함되는 행정경계 정보 조회

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/boundary/userarea.geojson





minx UTM-K 1 X좌표(최소)

miny UTM-K 1 Y좌표(최소)

maxx UTM-K 1 X좌표(최대)

maxy UTM-K 1 Y좌표(최대)

cd

1 : 시도

2 : 시군구

3 : 읍면동

4 : 집계구

1 요청 경계

















- 81 -

OpenAPI 정의서




응답 메시지

{


"id": "API_0706",


"errCd": 0,

"trId": "Qfpv_API_0706_1497240660819",

"features": [

{

"type": "Feature",

"geometry": {

"type": "Polygon",

"coordinates": [

[

[

956656.6232814789,

1950053.9580402374

],

[

956732.3751811981,

1949973.6250400543

]

]

]

},

"properties": {

"adm_cd": "1104073020001"

}

}

]

}

응답 에러코드


0 정상

- 82 -

OpenAPI 정의서





38. 임의 영역내 전개도 건물정보 API

서비스 명세

서비스

정보

서비스명 임의 영역내 전개도 건물정보 API

서비스 설명 임의 영역내 전개도 건물 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/figure/buildingarea.json





minx UTM-K 1 X좌표(최소)

miny UTM-K 1 Y좌표(최소)

maxx UTM-K 1 X좌표(최대)

maxy UTM-K 1 Y좌표(최대)




geometry LIST 1 건물 경계

bd_nm String 1 건물명

sufid String 1 건물유일 식별자

highest_flr String 1 건물 최상층

lowest_flr String 1 건물 최하층

bd_naddr String 1 건물 새주소



응답 메시지

{

"id": "API_0801",

"result": [



- 83 -

OpenAPI 정의서



{

"lowest_flr": "-5",

"bd_naddr": "서울특별시 중랑구 동일로 932 (묵동)",

"highest_flr": "35",

"sufid": "201009627135471957239550",

"bd_nm": "묵동자이아파트",

"geometry": [

0,

0,

0,

0,

6,

0,

0,

0,

1,

0,

-59,

-53,

89,

-33,

-47

]

}

],


"errCd": 0,

"trId": "hTsS_API_0801_1497243206680"

}

응답 에러코드


0 정상



- 84 -

OpenAPI 정의서



39. 건물 층정보 API

서비스 명세

서비스

정보

서비스명 건물 층정보 API

서비스 설명 임의 영역내 전개도 건물 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/figure/buildingattribute.json





sufid String 1 건물 유일 식별자





bd_nm String 1 건물명

dev_figure_type

정면도 :

10

평면도 :

01

혼합 : 11

none : 0

1 전개도 유형

bd_adm_addr String 1 행정동 주소

bd_naddr String 1 건물 새주소

highest_flr String 1 건물 최상층

lowest_flr String 1 건물 최하층



응답 메시지

{

"id": "API_0802",



- 85 -

OpenAPI 정의서



"result": {

"lowest_flr": "-5",

"bd_naddr": "서울특별시 중랑구 동일로 932 (묵동)",

"highest_flr": "35",

"bd_adm_addr": "서울특별시 중랑구 묵1동 170-1",

"sufid": "201009627135471957239550",

"dev_figure_type": "01",

"bd_nm": "묵동자이아파트"

},


"errCd": 0,

"trId": "lpko_API_0802_1497243542358"

}

응답 에러코드


0 정상



40. 층별 최외각 공간속성 API

서비스 명세

서비스

정보

서비스명 층별 최외각 공간속성 API

서비스 설명 층별 최외각 공간 속성 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/figure/floorboundary.json






flr_no String 1 건물 층 번호




- 86 -

OpenAPI 정의서






geometry List 1 경계

figure_type String

(값 : 1) 1 전개도 유형

main_yn String 1 대표층수



응답 메시지

{

"id": "API_0803",

"result": [

{

"main_yn": "Y",

"figure_type": "1",

"sufid": "201009627135471957239550",

"geometry": [

0,

0,

0,

0,

6,

0,

0,

0,

1,

0,

0,

0,

0,

3

]

}

],

- 87 -

OpenAPI 정의서




"errCd": 0,

"trId": "8am3_API_0803_1497244302722"

}

응답 에러코드


0 정상



41. 층별 사업체 공간속성 API

서비스 명세

서비스

정보

서비스명 층별 사업체 공간속성 API

서비스 설명 층별 사업체 공간 속성 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/figure/floorcompany.json










theme_cd_front String 1 테마코드

figure_type String

(값 : 2) 1 전개도 타입

decilist_serial String 1 확장명부일련번호

geometry List 1 경계




- 88 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0804",

"result": [

{

"theme_cd_front": "10",

"decilist_serial": "0003473437",

"figure_type": "2",

"geometry": [

0,

0,

0,

0,

6,

0,

0,

0,

1,

0,

0,

0

]

}

],


"errCd": 0,

"trId": "6Csr_API_0804_1497244930609"

}

응답 에러코드


0 정상



- 89 -

OpenAPI 정의서



42. 층별 시설물 공간속성 API

서비스 명세

서비스

정보

서비스명 층별 시설물 공간속성 API

서비스 설명 층별 시설물 공간 속성 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/figure/flooretcfacility.json










geometry LIST 1 경계

figure_type String

(값 : 3) 1 전개도 타입

fac_type

공실 : X

계단 : S

엘리베이터 : E

화장실 : T

출입구 : D

무빙워크 : M

1 시설물 종류



응답 메시지

{

"id": "API_0805",

"result": [

{



- 90 -

OpenAPI 정의서



"fac_type": "X",

"figure_type": "3",

"geometry": [

1,

6,

0,

0,

0,

1,

0,

0,

0,

1,

3,

0,

0,

0,

1

]

}

],


"errCd": 0,

"trId": "fy4I_API_0805_1497244931391"

}

응답 에러코드


0 정상



- 91 -

OpenAPI 정의서



43. 건물층별 사업체 정보 API

서비스 명세

서비스

정보

서비스명 건물층별 사업체 정보 API

서비스 설명 건물층별 사업체 정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/figure/floorcompanyinfo.json










companylist LIST 1 사업체정보

ㄴ center_x String 1 사업체 x 좌표

ㄴ center_y String 1 사업체 y 좌표

ㄴ corp_nm String 1 회사명

ㄴ decilist_serial String 1 확정명부일련번호

facilitylist LIST 1 시설정보

ㄴ center_x String 1 시설 x 좌표

ㄴ enter_y String 1 시설 y 좌표

ㄴ fac_type

공실 : X

계단 : S

엘리베이터 : E

화장실 : T

출입구 : D

무빙워크 : M

1 시설물 종류

theme_cd_list LIST 1 테마코드정보


ㄴ theme_cd_nm String 1 테마코드명



- 92 -

OpenAPI 정의서





응답 메시지

{

"id": "API_0806",

"result": {

"theme_cd_list": [

{

"theme_cd_nm": "기업(건설)",

"theme_cd": "8004"

}

],

"companylist": [

{

"center_y": 1948949.2015135044,

"center_x": 951157.4017595612,

"decilist_serial": "0000208978",

"corp_nm": "푸른솔"

}

],

"facilitylist": [

{

"center_y": 1948956.1639299402,

"center_x": 951172.2847362927,

"fac_type": "E"

}

]

},


"errCd": 0,

"trId": "bJpF_API_0806_1497246458798"

}

응답 에러코드


0 정상

- 93 -

OpenAPI 정의서





44. 지역현안 소통지도 목록 API

서비스 명세

서비스

정보

서비스명 지역현안 소통지도 목록 API

서비스 설명 지역현안 소통지도 목록을 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/statscommunity/list.json





page String 0 요청 페이지 번호

default:1

count String 0 요청 갯 수

default: 10

name String 0 소통지도 이름 검색 값




total_cnt String 1 전체 소통지도 수

count String 1 현재 조회 소통지도 수

page_num String 1 페이지 번호

community_list LIST 1 소통지도 정보

ㄴ cmmnty_nm String 1 소통지도이름

ㄴ cmmnty_id String 1 소통지도지도 일련번호

ㄴ intro String 1 소개

ㄴ cmmnty_open_date String 1 기간설정 시작일

ㄴ

cmmnty_partcptn_grant_yn String 1 소통지도 참여 승인여부

ㄴ main_photo String 1 대표사진




- 94 -

OpenAPI 정의서




응답 메시지

{

"id": "API_0901",

"result": {

"count": 10,

"total_cnt": 56,

"community_list": [

{

"cmmnty_open_date": "2017.06.09",

"cmmnty_partcptn_grant_yn": "A",

"cmmnty_id": 345,

"cmmnty_nm": "2017년 안산에너지절약마을만들기",

"main_photo": "/upload/community/main/201706/20170609-112820-311-729b1f7c-be42-4e3c-

b520-865059960c19.png",

"intro": "안산시 에너지 비전 2030 로드맵의 목표인 전력자립도 200% 달성과 시민 1가구 1발

전소 목표가 실현가능하도록 각 분야별로 약속이행 사항을 협약했다.\r\n11동 35개 아파트단지와 지역

의 10개 시민단체가 참여해 진행되는 프로그램은 과소비 가정에너지 진단, 청소년에너지서포터즈양성,

에너지캠페인, 에너지의 날 행사 등이다."

},

{

"cmmnty_open_date": "2017.06.09",

"cmmnty_partcptn_grant_yn": "A",

"cmmnty_id": 344,

"cmmnty_nm": "에너지절약마을 만들기",

"main_photo": "/upload/community/main/201706/20170609-111845-073-af6b3545-278e-4085-

b85f-b4f83c6c0545.png",

"intro": "에너지절약마을 만들기 진단아파트"

}

],

"page_num": 1

},


"errCd": 0,

"trId": "YbWE_API_0901_1497248335645"

}

- 95 -

OpenAPI 정의서



응답 에러코드


0 정상



45. 지역현안 소통지도 상세 API

서비스 명세

서비스

정보

서비스명 지역현안 소통지도 상세 API

서비스 설명 지역현안 소통지도 상세정보를 제공하는 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/statscommunity/opinionlist.json





cmmnty_map_id String 1 소통지도 ID

count String 0 요청 갯 수

default: 10

page String 0 요청 페이지 번호

default:1

x_coor String 0 X좌표

y_coor String 0 Y좌표




total_cnt String 1 전체 소통지도 수

count String 1 현재 조회 소통지도 수

page_num String 1 페이지 번호

poi_list LIST 1 POI정보

ㄴ cmmnty_poi_id String 1 등록 의견 식별변호

ㄴ usr_id String 1 등록자 아이디



- 96 -

OpenAPI 정의서



ㄴ icon_id String 1 등록 아이콘 식별번호

ㄴ icon_name String 1 등록 아이콘 이름

ㄴ icon_path String 1 등록 아이콘 이미지

ㄴ tot_reg_cd String 1 집계구 코드

ㄴ x_coor String 1 의견 x좌표

ㄴ y_coor String 1 의견 y좌표

ㄴ distance String 1 중심점으로 부터 거리(단위 : m)

ㄴ angle String 1 중심점으로 부터 각도



응답 메시지

{

"id": "API_0902",

"result": {

"count": 10,

"total_cnt": 35,

"page_num": 1,

"poi_list": [

{

"icon_id": 1855,

"y_coor": 1924220.15609993,

"distance": 33327.48624497192,

"cmmnty_poi_id": 3115,

"usr_id": "angeljho",

"icon_name": "전구",

"x_coor": 940337.382232385,

"icon_path": "/img/community/iconset_d5.png",

"tot_reg_cd": "3109273030104",

"angle": 39.410291733327796

}

]

},


"errCd": 0,

"trId": "UpeI_API_0902_1497249390339"

- 97 -

OpenAPI 정의서



}

응답 에러코드


0 정상



46. 전국 기술업종 정보 API

서비스 명세

서비스

정보

서비스명 전국 기술업종 정보 API

서비스 설명 전국 기술업종 정보를 조회하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/technicalbiz/companyinfo.json








year String 1 조회연도

techbiz_corp_total_cnt String 1 사업체 전체 수

techbiz_list LIST 1 기술업종정보

ㄴ techbiz_cd String 1 기술업종코드

ㄴ techbiz_nm String 1 기술업종분류명

ㄴ techbiz_corp_cnt String 1 사업체 수

ㄴ techbiz_corp_per String 1 사업체 비율

ㄴ techbiz_corp_irdsrate String 1 사업체 증감률



응답 메시지



- 98 -

OpenAPI 정의서



{

"id": "API_1101",

"result": [

{

"techbiz_list": [

{

"techbiz_corp_cnt": 3961,

"techbiz_cd": "11",

"techbiz_corp_per": "6.5",

"techbiz_nm": "첨단기술",

"techbiz_corp_irdsrate": "10"

},

{


"techbiz_cd": "12",


"techbiz_nm": "고기술",

"techbiz_corp_irdsrate": "4.5"

}

],

"year": "2010",

"techbiz_corp_total_cnt": "423017"

}

],


"errCd": 0,

"trId": "oYAz_API_1101_1497250356378"

}

응답 에러코드


0 정상



- 99 -

OpenAPI 정의서



47. 시도별 기술업종 정보 API

서비스 명세

서비스

정보

서비스명 시도별 기술업종 정보 API

서비스 설명 시도별 기술업종 정보를 조회하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/technicalbiz/sidocompanyinfo.json










techbiz_corp_total_cnt String 1 사업체 전체 수

techbiz_list LIST 1 기술업종정보

ㄴ techbiz_cd String 1 기술업종코드

ㄴ techbiz_nm String 1 기술업종분류명

ㄴ techbiz_corp_cnt String 1 사업체 수

ㄴ techbiz_corp_per String 1 사업체 비율

ㄴ techbiz_corp_irdsrate String 1 사업체 증감률



응답 메시지

{

"id": "API_1102",

"result": [

{

"techbiz_list": [

{



- 100 -

OpenAPI 정의서




"techbiz_cd": "11",



"techbiz_corp_irdsrate": "10"

},

{


"techbiz_cd": "12",


"techbiz_nm": "고기술",

"techbiz_corp_irdsrate": "4.5"

}

],

"sido_nm": "제주특별자치도",

"techbiz_corp_total_cnt": "3382",

"sido_cd": "39"

}

],


"errCd": 0,

"trId": "DPA5_API_1102_1497250897870"

}

응답 에러코드


0 정상



48. 시군구별 기술업종 정보 API

서비스 명세

서비스

정보

서비스명 시군별 기술업종 정보 API

서비스 설명 시군구별 기술업종 정보를 조회하기 위한 API

- 101 -

OpenAPI 정의서



요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/technicalbiz/sggcompanyinfo.json





techbiz_cd 기술업종 코드표 참

고 1 기술업종 코드


※ 기술업종코드표 참조 :

https://sgis.kostat.go.kr:8080/developer/html/openApi/api/dataCode/TechbizCode.html



techbiz_cd String 1 기술업종코드

techbiz_nm String 1 기술업종분류명






y_coor String 1 시군구 Y 좌표

techbiz_corp_cnt String 1 사업체 수

techbiz_corp_per String 1 사업체 비율

techbiz_corp_irdsrate String 1 사업체 증감률



응답 메시지

{

"id": "API_1103",

"result": [

{

"sgg_cd": "010 ",

"y_coor": "1952715",




https://sgis.kostat.go.kr:8080/developer/html/openApi/api/dataCode/TechbizCode.html

- 102 -

OpenAPI 정의서



"x_coor": "954045",


"techbiz_cd": "11",



"techbiz_corp_irdsrate": "11.4",

"sgg_nm": "종로구",

"sido_cd": "11"

},

{

"sgg_cd": "020 ",

"y_coor": "1951723",


"x_coor": "955627",

"techbiz_corp_per": "1",

"techbiz_cd": "11",



"techbiz_corp_irdsrate": "10.4",

"sgg_nm": "중구",

"sido_cd": "11"

}

],


"errCd": 0,

"trId": "TcGQ_API_1103_1497251226565"

}

응답 에러코드


0 정상



- 103 -

OpenAPI 정의서



49. 소지역 코드찾기 API

서비스 명세

서비스

정보

서비스명 소지역 코드찾기 API

서비스 설명 좌표를 이용한 집계구, 행정동코드 정보를 조회하기 위한 API

요청주소 https://sgisapi.kostat.go.kr/OpenAPI3/personal/findcodeinsmallarea.json





x_coor String 1 X 좌표

y_coor String 1 Y 좌표








emdong_nm String 1 읍면동명

emdong_cd String 1 읍면동코드

tot_reg_cd String 1 집계구코드



응답 메시지

{

"id": "API_9901",

"result": {

"sgg_cd": "040",

"emdong_cd": "69",




- 104 -

OpenAPI 정의서



"sgg_nm": "성동구",

"emdong_nm": "송정동",

"tot_reg_cd": "1104069020001",

"sido_cd": "11"

},


"errCd": 0,

"trId": "km0m_API_9901_1497254482283"

}

응답 에러코드


0 정상



Documents

OpenAPI 정의서 · 2019-03-18 · "trId": "DUmk_API_0301_1496648537644" } 응답 에러코드 응답코드(결과코드) 설명 0 정상 -401 필수파라미터 누락 -100 검색결과