소상공인진흥공단 상가업소 데이터 조회하기

파이썬 PublicDataReader 라이브러리를 이용하면 공공데이터포털에서 제공하는 소상공인진흥공단 상가업소 데이터를 쉽게 조회할 수 있습니다.

PublicDataReader

PublicDataReader는 공공 데이터를 자동으로 조회할 수 있는 파이썬 라이브러리입니다. 이 라이브러리로 공공데이터포털과 국가통계포털(KOSIS)과 같이 오픈 API 서비스로 제공하는 공공 데이터를 쉽게 조회할 수 있습니다. 인증키가 필요한 공공 데이터는 인증키를 사용하여 조회할 수 있고, 인증키가 필요하지 않은 데이터는 별도의 인증 절차 없이 조회할 수 있습니다. PublicDataReader를 이용하면 일반적인 공공 데이터 조회 과정에서 필요한 API 명세 찾기, 요청 작성, 반환된 데이터 정리 과정을 자동으로 처리할 수 있고, 웹에 공개된 데이터를 조회할 때도 데이터 수집과 가공 과정을 자동화할 수 있습니다. 이를 통해 코드 작성이 간결해지고 공공 데이터 조회 작업이 편리해집니다.

소상공인 상가업소 정보 조회 서비스

PublicDataReader를 통해 공공데이터포털에서 제공하는 Open API 서비스를 정상적으로 이용하려면 아래 서비스 신청 페이지 링크에 접속 후 서비스 이용 신청을 해야 합니다. 서비스 신청을 완료하면 Open API를 사용할 수 있는 서비스 키가 발급됩니다. 서비스 제공 기관에 따라 서비스 키 발급 후 약 1~2일이 지난 후 접근 권한이 부여될 수 있습니다. 충분한 시간이 지난 후에도 접근 권한이 부여되지 않는다면 서비스 제공처에 문의하는 것을 권장합니다.

소상공인 상가업소 정보 조회 서비스 신청 페이지

서비스명	카테고리명
지정 상권조회	지정상권
반경내 상권조회	반경상권
사각형내 상권조회	사각형상권
행정구역 단위 상권조회	행정구역상권
단일 상가업소 조회	단일상가
건물단위 상가업소 조회	건물상가
지번단위 상가업소 조회	지번상가
행정동 단위 상가업소 조회	행정동상가
상권내 상가업소 조회	상권상가
반경내 상가업소 조회	반경상가
사각형내 상가업소 조회	사각형상가
다각형내 상가업소 조회	다각형상가
업종별 상가업소 조회	업종별상가
수정일자기준 상가업소 조회	수정일자상가
상권정보 업종 대분류 조회	업종대분류
상권정보 업종 중분류 조회	업종중분류
상권정보 업종 소분류 조회	업종소분류

PublicDataReader 설치하기

운영체제(OS)에 따라 아래 중 하나를 선택합니다.

Windows: CMD(명령 프롬프트) 실행
Mac: Terminal(터미널) 실행

아래 Shell 명령어를 입력 후 실행합니다.

pip install PublicDataReader --upgrade

오픈 API 서비스 키 입력하기

공공데이터포털에서 발급받은 서비스 키를 복사하여 다음과 같이 serviceKey 변수에 할당합니다. 오픈 API 서비스 키 발급 방법에 대해 궁금하신 분들은 구글에 ‘공공데이터포털 오픈 API 사용법‘을 검색하시면 여러 문서들을 참조할 수 있습니다.

service_key = "공공데이터포털에서 발급받은 서비스 키"

데이터 조회 세션 만들기

다음과 같이 발급받은 serviceKey 값을 이용해 부동산 실거래가 데이터를 조회할 si 세션을 만들어줍니다. 본 라이브러리를 정상적으로 이용하기 위해서는 소상공인 상가업소 정보 조회 서비스에 대한 OpenAPI 활용신청을 반드시 완료해야합니다.

# 상가업소 정보 조회 클래스 임포트하기
from PublicDataReader import SmallShop

# 데이터 조회 API 인스턴스 만들기
api = SmallShop(service_key)

데이터 조회하기

지정 상권조회

df = api.get_data(
    service_name = "지정상권",
    key = "9301",
)
df.tail(1)

	상권번호	상권명	시도코드	시도명	시군구코드	시군구명	면적	좌표개수	좌표값	데이터기준일자
0	9301	압구정 로데오거리_1	11	서울특별시	11680	강남구	193739	19	MULTIPOLYGON (((127.04700219001 37.52446081421...	2021-06-30

반경내 상권조회

df = api.get_data(
    service_name = "반경상권",
    cx = 127.042325940821,
    cy = 37.5272105674053,
    radius = 500,
)
df.tail(1)

	상권번호	상권명	시도코드	시도명	시군구코드	시군구명	면적	좌표개수	좌표값	데이터기준일자
2	9316	청담사거리_1	11	서울특별시	11680	강남구	20169	21	MULTIPOLYGON (((127.045624467128 37.5237563085...	2021-06-30

사각형내 상권조회

df = api.get_data(
    service_name = "사각형상권",
    minx = 127.0327683531071,
    miny = 37.495967935149146,
    maxx = 127.04268179746694,
    maxy = 37.502402894207286
)
df.tail(1)

	상권번호	상권명	시도코드	시도명	시군구코드	시군구명	면적	좌표개수	좌표값	데이터기준일자
2	9308	역삼역_2	11	서울특별시	11680	강남구	51935	32	MULTIPOLYGON (((127.042493260333 37.5022663760...	2021-06-30

행정구역 단위 상권조회

df = api.get_data(
    service_name = "행정구역상권",
    divId = 'adongCd',
    key = '1168058000'
)
df.tail(1)

	상권번호	상권명	시도코드	시도명	시군구코드	시군구명	면적	좌표개수	좌표값	데이터기준일자
2	9323	포스코사거리_2	11	서울특별시	11680	강남구	79514	34	MULTIPOLYGON (((127.053620405866 37.5128036692...	2021-06-30

단일 상가업소 조회

df = api.get_data(
    service_name = "단일상가",
    divId = 'adongCd',
    key = '11757465'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
0	11757465	스타벅스	방배점	Q	음식	Q12	커피점/카페	Q12A01	커피전문점/카페/다방	I56220	...	1165010100108120002009897	None	서울특별시 서초구 방배로 211, (방배동)	137832	06562	None	1	None	126.99050928001	37.4919441682448

1 rows × 39 columns

건물단위 상가업소 조회

df = api.get_data(
    service_name = "건물상가",
    key = '1168011000104940000004966'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
82	28508108	아모레퍼시픽백화점갤러리아압구정	None	D	소매	D16	화장품소매	D16A01	화장품판매점	G47813	...	1168011000104940000004966	갤러리아백화점	서울특별시 강남구 압구정로 343, (압구정동)	135902	06008	None	1	None	127.04008070443	37.5284986430328

1 rows × 39 columns

지번단위 상가업소 조회

df = api.get_data(
    service_name = "지번상가",
    key = '1165010100108120002'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
1	17875647	키무브필라테스스튜디오	None	N	관광/여가/오락	N05	요가/단전/마사지	N05A01	요가/단식	S96129	...	1165010100108120002009897	None	서울특별시 서초구 방배로 211, (방배동)	137832	06562	None	5	None	126.990621865291	37.4919811723816

1 rows × 39 columns

행정동 단위 상가업소 조회

df = api.get_data(
    service_name = "행정동상가",
    divId = 'adongCd',
    key = '1168064000',
    indsLclsCd = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
999	17078682	투썸플레이스	강남역KR타워점	Q	음식	Q12	커피점/카페	Q12A01	커피전문점/카페/다방	I56220	...	1168010100108250026024506	None	서울특별시 강남구 강남대로84길 13, (역삼동)	135934	06232	None	None	None	127.029572455617	37.4968668925481

1 rows × 39 columns

상권내 상가업소 조회

df = api.get_data(
    service_name = "상권상가",
    key = '9368',
    indsLclsCd = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
188	9136408	KFC역삼점	역삼점	Q	음식	Q05	닭/오리요리	Q05A08	후라이드/양념치킨	I56193	...	1168010100106420010026120	송암II빌딩	서울특별시 강남구 논현로 509, (역삼동)	135910	06132	None	1	None	127.036078078957	37.5019210138113

1 rows × 39 columns

반경내 상가업소 조회

df = api.get_data(
    service_name = "반경상가",
    radius = '500',
    cx = 127.03641615737838,
    cy = 37.50059843782878,
    indsLclsCd = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
847	9136408	KFC역삼점	역삼점	Q	음식	Q05	닭/오리요리	Q05A08	후라이드/양념치킨	I56193	...	1168010100106420010026120	송암II빌딩	서울특별시 강남구 논현로 509, (역삼동)	135910	06132	None	1	None	127.036078078957	37.5019210138113

1 rows × 39 columns

사각형내 상가업소 조회

df = api.get_data(
    service_name = "사각형상가",
    minx = 127.0327683531071,
    miny = 37.495967935149146,
    maxx = 127.04268179746694,
    maxy = 37.502402894207286,
    indsLclsCd = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
579	9136408	KFC역삼점	역삼점	Q	음식	Q05	닭/오리요리	Q05A08	후라이드/양념치킨	I56193	...	1168010100106420010026120	송암II빌딩	서울특별시 강남구 논현로 509, (역삼동)	135910	06132	None	1	None	127.036078078957	37.5019210138113

1 rows × 39 columns

다각형내 상가업소 조회

df = api.get_data(
    service_name = "다각형상가",
    key = 'POLYGON((127.02355609555755 37.504264372557095, 127.02496157306963 37.50590702991155, 127.0270858825753 37.50486867039889, 127.02628121988377 37.503489842823114))',
    indsLclsCd = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
47	26260692	신마포갈매기	신논현역점	Q	음식	Q01	한식	Q01A02	갈비/삼겹살	I56111	...	1168010100108100000022737	None	서울특별시 강남구 강남대로110길 12, (역삼동)	135931	06123	None	2	None	127.025806325949	37.5038461003511

1 rows × 39 columns

업종별 상가업소 조회

df = api.get_data(
    service_name = "업종별상가",
    divId = 'indsLclsCd',
    key = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물관리번호	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도
999	11181582	내수한우마을	None	Q	음식	Q01	한식	Q01A01	한식/백반/한정식	I56111	...	4371025041001700005054390	None	충청북도 청주시 청원구 내수읍 청암로 111, (학평리)	363934	28146	None	1	None	127.542578061469	36.7252477746175

1 rows × 39 columns

수정일자기준 상가업소 조회

df = api.get_data(
    service_name = "수정일자상가",
    key = '20200101',
    indsLclsCd = 'Q'
)
df.tail(1)

	상가업소번호	상호명	지점명	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	표준산업분류코드	...	건물명	도로명주소	구우편번호	신우편번호	동정보	층정보	호정보	경도	위도	chgGb
2	25852182	그랜드테이블	None	Q	음식	Q06	양식	Q06A05	패밀리레스토랑	I56114	...	해운대그랜드호텔	부산광역시 해운대구 해운대해변로 217, (우동)	612821	48093	None	1	None	129.155174224526	35.1591175731937	U

1 rows × 40 columns

상권정보업종 대분류 조회

df = api.get_data(
    service_name = "업종대분류",
)
df.tail(1)

	상권업종대분류코드	상권업종대분류명	데이터기준일자
41	R	학문/교육	2015-12-17

상권정보업종 중분류 조회

df = api.get_data(
    service_name = "업종중분류",
    indsLclsCd = 'Q'
)
df.tail(1)

	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	데이터기준일자
31	Q	음식	Q01	한식	2015-12-17

상권정보업종 소분류 조회

df = api.get_data(
    service_name = "업종소분류",
    indsLclsCd = 'Q',
    indsMclsCd = 'Q01'
)
df.tail(1)

	상권업종대분류코드	상권업종대분류명	상권업종중분류코드	상권업종중분류명	상권업종소분류코드	상권업종소분류명	데이터기준일자
20	Q	음식	Q01	한식	Q01A18	황태전문	2015-12-17

참고

Twitter Facebook LinkedIn

PublicDataReader - 상가업소 데이터 조회하기

소상공인진흥공단 상가업소 데이터 조회하기

소상공인진흥공단 상가업소 데이터 조회하기

PublicDataReader

소상공인 상가업소 정보 조회 서비스

PublicDataReader 설치하기

오픈 API 서비스 키 입력하기

데이터 조회 세션 만들기

데이터 조회하기

참고

공유하기

댓글남기기

참고

Spark Kafka 설치 방법(Docker Compose)

Running LLM locally with GGUF files

GGUF 파일로 로컬에서 LLM 실행하기

LLM 모델 저장 형식 GGML, GGUF