최고수 공작소

전국 축제·공연행사 — 관광공사 + 지자체 표준데이터

전국에서 열리는 축제와 공연·전시의 이름·기간·장소·좌표입니다. 세 곳에서 받아 합칩니다. 한국관광공사가 관리하는 축제 정보, 지방자치단체가 직접 올리는 전국문화축제표준데이터, 같은 방식의 전국공연행사정보표준데이터입니다. 같은 주말을 세 원천으로 재 봤을 때 서로 겹치는 행사가 거의 없어, 한 곳만 쓰면 나머지가 통째로 빠집니다.

인용과 내려받기

한국관광공사 · 행정안전부(지자체), 「전국 축제·공연행사 — 관광공사 + 지자체 표준데이터」, 2026-11-09 기준. 최고수 공작소 가공. https://python-choigosu.com/data/festival-2026/ (확인일: YYYY-MM-DD).

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

전체 CSV 내려받기 1,269행 · 12열 기관 원본 페이지 필드 사전

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

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

출처와 이용조건

전국 축제·공연행사 — 관광공사 + 지자체 표준데이터의 출처 기관·원본·이용조건·마지막으로 받은 때·담긴 곳 수
자료 IDfestival-2026
출처 기관한국관광공사 · 행정안전부(지자체)
원본 https://www.data.go.kr/data/15101578/openapi.do
이용조건 저작자표시

세 원천 모두 공공데이터포털 활용신청 화면의 이용허락범위가 "저작자표시"로 고지돼 있습니다 [확인 2026-08-17].

데이터 기준일
최종 수집
담긴 곳 319건
기간2026
지역대한민국
새로 고침 주기 주 1회 자동으로 받습니다. 14일이 넘으면 늦어졌다고 적음
쓰는 도구 이번 주말 뭐하지

어느 경로로 받았나

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

  1. HTTP GET (오픈API) 인증 필요

    https://apis.data.go.kr/B551011/KorService2/searchFestival2

    파라미터 serviceKey · MobileOS · MobileApp · _type=json · eventStartDate · numOfRows=1000 · pageNo

    한국관광공사 국문 관광정보 서비스입니다. 활용신청 승인 후 인증키가 필요합니다. eventStartDate 는 "그 날짜 이후 시작하는 축제"를 뜻하므로, 진행 중인 축제를 놓치지 않으려면 오늘이 아니라 과거 날짜를 넣어야 합니다. 구 KorService1 은 폐기됐습니다 [확인 2026-08-17].

  2. HTTP GET (오픈API) 인증 필요

    https://api.data.go.kr/openapi/tn_pubr_public_cltur_fstvl_api

    파라미터 serviceKey · type=json · pageNo · numOfRows=1000

    전국문화축제표준데이터(15013104). 지방자치단체가 직접 등록합니다.

  3. HTTP GET (오픈API) 인증 필요

    https://api.data.go.kr/openapi/tn_pubr_public_pblprfr_event_info_api

    파라미터 serviceKey · type=json · pageNo · numOfRows=1000

    전국공연행사정보표준데이터(15013106). 공연·전시가 주를 이룹니다.

커버리지

전국 축제·공연행사 — 관광공사 + 지자체 표준데이터의 지역 커버리지
범위지방자치단체가 등록한 것만 들어옵니다. 그래서 축제가 실제로 많은 곳이 아니라 자료를 성실히 올리는 곳이 많아 보일 수 있습니다. 원본 10,699건 가운데 이미 끝난 행사와 1년 내내 열리는 상설 프로그램을 빼면 지금 화면에 오르는 것은 572건입니다 [실측 2026-08-17].
데이터가 있는 지역 244개 시군구 · 16개 시도
지역 페이지 182개. 담긴 곳이 3건 미만인 지역은 만들지 않습니다 — 내용 없는 페이지를 대량 생산하지 않기 위해서입니다.
지역 미매칭 주소에서 시·군·구를 뽑지 못한 곳 0곳

스냅샷 이력

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

원본 스냅샷 파일 목록
수집일 파일 구분 크기(압축)
data/raw/ibeon-jumal/2026-11-09.json.gz 본체 916.9KB

가공 산출물: data/dist/ibeon-jumal/index.json 29.8KB · data/dist/ibeon-jumal/meta.json 472B

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

알려진 한계

  • 지방자치단체가 등록한 행사만 들어옵니다. 축제가 많은 지역이 아니라 자료를 성실히 올리는 지역이 많아 보일 수 있습니다
  • 1년 내내 열리는 상설 프로그램은 뺐습니다. 기간이 60일을 넘으면 싣지 않습니다
  • 요금 정보는 공연, 행사 원천에만 있어, 무료 표시가 없다고 해서 유료라는 뜻은 아닙니다
  • 좌표가 없는 행사는 지도에 찍을 자리가 없어 싣지 못했습니다
  • 기간과 장소는 주최 측이 신고한 값이며 사정에 따라 바뀔 수 있습니다. 가시기 전에 문의처로 확인하십시오

각 항목을 풀어 쓴 설명과 자주 묻는 질문은 이번 주말 뭐하지 자료 설명에 있습니다. 여기 적힌 출처나 이용조건이 틀렸다면 알려 주세요.

형식

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

전국 축제·공연행사 — 관광공사 + 지자체 표준데이터의 필드 목록과 채움률
열 이름 형 채움률 설명
id 행사 번호 string 100.0% (1,269) 관광공사 콘텐츠 번호이거나, 원본에 고유번호가 없는 표준데이터는 이름·시작일·주소로 우리가 만든 값입니다.
name 행사 이름 string 100.0% (1,269) 축제명 또는 행사명.
원본 항목 title / fstvlNm / eventNm
from 시작일 string 100.0% (1,269) YYYYMMDD. 이 도구에서 가장 중요한 값입니다.
원본 항목 eventstartdate / fstvlStartDate / eventStartDate
to 종료일 string 100.0% (1,269) YYYYMMDD. 오늘보다 이르면 화면에 올리지 않습니다.
원본 항목 eventenddate / fstvlEndDate / eventEndDate
lat 위도 coordinate 100.0% (1,269) WGS84 위도. 창 안 레코드의 약 19%가 비어 있어 그 건은 싣지 않습니다.
원본 항목 mapy / latitude
lng 경도 coordinate 100.0% (1,269) WGS84 경도.
원본 항목 mapx / longitude
addr 주소 string 100.0% (1,269) 도로명주소 또는 지번주소.
원본 항목 addr1 / rdnmadr / lnmadr
sgg 시군구 코드 string 100.0% (1,269) 행정안전부 행정표준코드 5자리. 좌표를 경계와 맞춰 우리가 붙인 값이며 원본에는 없습니다.
cat 종류 string 100.0% (1,269) 축제 또는 공연·전시. 어느 원천에서 왔는지로 가릅니다 — 내용을 읽어 추정하지 않습니다.
tel 전화번호 string 98.0% (1,243) 문의처.
원본 항목 tel / phoneNumber
free 무료 boolean 0.0% (0) 요금 정보가 "무료"로 적힌 것만 참입니다. 요금 필드가 있는 원천이 공연행사뿐이라 비어 있는 곳이 많고, 모르는 것을 유료로 적지 않습니다.
원본 항목 chrgeInfo
weekendOpen 주말에 열림 boolean 0.0% (0) 기간에 토요일이나 일요일이 하루라도 들어가면 참입니다.

도구 59개 중 2개 늦어짐 쓰는 자료 58개 받은 때 2026-11-12 07:18 KST 알려진 문제 자료 전부