최고수 공작소

전국 온누리상품권 가맹점 현황

전국에서 온누리상품권을 받는 가게를 소상공인시장진흥공단이 모아 공개하는 자료입니다. 가게 이름, 소속 시장이나 상점가 이름, 시도, 취급 품목, 종이 상품권과 디지털 상품권(충전식 카드, 모바일)을 받는지, 가맹 등록 연도가 들어 있습니다.

인용과 내려받기

소상공인시장진흥공단, 「전국 온누리상품권 가맹점 현황」, 2026-07-31 기준. 최고수 공작소 가공. https://python-choigosu.com/data/onnuri-2026/ (확인일: YYYY-MM-DD).

기준일 2026-07-31 은 원본 기관이 공개한 자료의 날짜이고, 최종 수집은 2026-11-03 입니다. 이 주소는 최신 수집분을 가리키므로, 특정 시점을 인용하실 때는 위 기준일을 함께 적어 주십시오 — 그 시점의 원본은 아래 스냅샷 이력에 그대로 남아 있습니다.

전체 CSV 내려받기 3,699행 · 11열 기관 원본 페이지 필드 사전

UTF-8 BOM 을 붙였습니다. 한국어 Windows 의 Excel 은 BOM 이 없는 UTF-8 CSV 를 cp949 로 해석해 상호와 주소가 전부 깨집니다. 이 파일의 1차 독자가 기자와 연구자이고 그들이 여는 도구가 대부분 Excel 이므로, 그쪽이 바로 열리는 쪽을 골랐습니다. pandas·R·duckdb 로 읽으실 때는 인코딩을 utf-8-sig 로 지정하시면 됩니다 (지정하지 않으면 첫 열 이름 앞에 보이지 않는 문자가 붙습니다 — 그렇게 눈에 보이는 실패가 되도록 고른 것입니다). 줄바꿈은 CRLF(RFC 4180), 참·거짓 항목은 참일 때 Y, 아니면 빈 칸입니다.

이용조건이 미확인인 동안 원본 전량을 그대로 재배포하지 않으며, 이 CSV 는 주소를 정리하고 시군구 코드를 붙인 가공본입니다.

출처와 이용조건

전국 온누리상품권 가맹점 현황의 출처 기관·원본·이용조건·마지막으로 받은 때·담긴 곳 수
자료 IDonnuri-2026
출처 기관소상공인시장진흥공단
원본 https://www.data.go.kr/data/3060079/fileData.do
이용조건 이용허락범위 제한 없음

공공데이터포털 자료 쪽의 이용허락범위가 제한 없음입니다 [확인 2026-11-03].

데이터 기준일
최종 수집
담긴 곳 3,699곳
기간파일 기준일의 가맹 현황(지금 쓰는 파일은 2026-07-31 기준)
지역대한민국
새로 고침 주기 연 1회 새로 나오는 자료라 새로 공표될 때 받습니다. 400일이 넘으면 늦어졌다고 적음
쓰는 도구 온누리상품권 사용처 지도

어느 경로로 받았나

재현에 필요한 것을 전부 적습니다. 공식 오픈API 인지 아닌지도 그대로 밝힙니다 — 경로를 숨기면 재현할 수 없고, 재현할 수 없는 자료는 인용할 가치가 없습니다.

  1. 파일 내려받기(CSV) 인증 불필요

    https://www.data.go.kr/data/3060079/fileData.do

    파라미터 자료 쪽의 다운로드 단추(CSV 한 장, UTF-8)

    로그인 없이 내려받습니다. 해마다 한 번 새 파일로 바꿉니다(파일 이름 끝이 기준일).

커버리지

전국 온누리상품권 가맹점 현황의 지역 커버리지
범위온누리상품권 가맹점 전부. 원본에 가게 주소가 없어 같은 시도의 같은 시장 이름을 한 곳으로 묶고, 시장 자리는 카카오 검색으로 찾았습니다. 찾지 못한 시장은 지도에 싣지 않았습니다.
데이터가 있는 지역 255개 시군구 · 16개 시도
지역 페이지 255개. 자료가 있는 지역마다 한 장씩 만듭니다.
지역 미매칭 주소에서 시·군·구를 뽑지 못한 곳 0곳

스냅샷 이력

받은 원본을 항목을 골라내지 않고 통째로 압축해 보관해 둡니다. 필요한 것만 남기면 공공데이터의 항목이 바뀐 사실 자체를 영원히 알 수 없기 때문입니다. 원본 API 가 죽어도 이 스냅샷만으로 사이트를 다시 빌드할 수 있습니다.

원본 스냅샷 파일 목록
수집일 파일 구분 크기(압축)
data/raw/onnuri/2026-11-03.json.gz 본체 3.4MB

가공 산출물: data/dist/onnuri/index.json 127.4KB · data/dist/onnuri/meta.json 462B

보존 정책 — 최신 1개와 매월 1일자 수집분은 영구 보관하고, 그 사이 주간 수집분은 정리합니다.

알려진 한계

  • 원본에 가게 주소가 없어 시장과 상점가 단위로 지도에 세웠습니다. 가게 하나하나의 자리는 시장 안에서 직접 찾아 주세요
  • 시장 자리는 시장 이름과 그 안 가게 이름으로 카카오 검색에서 찾았고, 찾지 못한 시장은 지도에 싣지 않았습니다. 그 수는 자료 설명에서 보실 수 있습니다
  • 목록은 소상공인시장진흥공단이 공개한 기준일의 가맹 현황이라 그 뒤에 새로 가맹하거나 그만둔 가게는 맞지 않을 수 있습니다
  • 카드와 모바일은 디지털 온누리상품권(충전식 카드, 모바일)을 받는 가게 수입니다. 종이 상품권은 원본의 모든 가게가 받습니다
  • 원본에 전화번호와 영업시간이 없어 싣지 않았습니다. 가기 전에 확인해 주세요

각 항목을 풀어 쓴 설명과 자주 묻는 질문은 온누리상품권 사용처 지도 자료 설명에 있습니다. 여기 적힌 출처나 이용조건이 틀렸다면 알려 주세요.

형식

아래 열 이름이 CSV 의 머리글이자 JSON 파일의 키입니다. 채움률은 이번 수집분 3,699건을 직접 세어 계산했습니다. 참·거짓 항목은 참인 건수만 셉니다 — 원본이 참일 때만 기록하기 때문입니다.

전국 온누리상품권 가맹점 현황의 필드 목록과 채움률
열 이름 형 채움률 설명
id 시장 키 string 100.0% (3,699) 시도와 시장 이름으로 우리가 만든 10자리 키입니다. 원본에는 번호가 없습니다.
name 시장이나 상점가 이름 string 100.0% (3,699) 원본 그대로입니다.
원본 항목 소속 시장명(또는 상점가)
lat 위도 coordinate 100.0% (3,699) WGS84 위도. 원본에 없어 시장 이름과 가게 이름으로 찾은 값입니다.
lng 경도 coordinate 100.0% (3,699) WGS84 경도. 원본에 없어 시장 이름과 가게 이름으로 찾은 값입니다.
addr 주소 string 100.0% (3,699) 자리를 찾을 때 나온 카카오 장소의 주소입니다. 원본에는 시도만 있습니다.
cat 종류 string 100.0% (3,699) 이름에 골목형이 들면 골목형상점가, 시장이나 장터가 들면 전통시장, 나머지는 상점가로 우리가 나눴습니다.
원본 항목 소속 시장명(또는 상점가)
shops 가맹점 수 number 100.0% (3,699) 같은 시도에서 이 시장 이름으로 실린 가게 수입니다.
원본 항목 가맹점명
digitalText 카드, 모바일 string 100.0% (3,699) 디지털형 가맹 여부가 Y 인 가게 수입니다.
원본 항목 디지털형 가맹 여부
itemsText 많은 품목 string 97.6% (3,609) 취급품목이 같은 가게를 세어 많은 여섯 가지와 나머지 수를 적었습니다. 빈 품목은 세지 않았습니다.
원본 항목 취급품목
storesText 가게 string 100.0% (3,699) 가게 이름을 가나다순으로 30곳까지 적고 나머지는 수로 적었습니다.
원본 항목 가맹점명, 취급품목
sgg 시군구 코드 string 100.0% (3,699) 행정표준코드 5자리. 찾은 주소를 읽어 우리가 붙인 값이며 원본에는 없습니다.

도구 52개 중 1개 늦어짐 쓰는 자료 51개 받은 때 2026-11-03 10:44 KST 알려진 문제 자료 전부