전남광주통합특별시 보성군_ 문화 행사 정보 데이터 조회 서비스

본 데이터는 전라남도 보성군 내에서 개최되는 다양한 문화 행사, 지역 축제 및 예술 공연 정보를 실시간으로 조회할 수 있는 오픈 API 서비스이다. 보성군은 지역을 방문하는 관광객과 군민들에게 풍성한 즐길 거리를 제공하고, 민간 개발자들이 지역 관광 정보를 효율적으로 활용할 수 있도록 행사의 핵심 데이터를 표준화된 형식으로 개방하고 있다. 데이터의 주요 응답 항목은 행사 구분(온라인/오프라인), 행사 명칭, 개최 장소, 행사 내용 요약, 시작 및 종료 일자, 운영 시간, 입장료 정보, 주관 및 주최 기관, 그리고 도로명 주소 기반의 상세 위치와 연락처 등으로 구성되어 있다.제공되는 정보는 보성군의 대표 축제인 보성다향대축제 내에서 운영되는 티마스터 챔피언십, 한국명차선정대회 등 차(茶) 문화 특화 행사를 비롯하여 율포 해수풀장에서 열리는 지역 민속 공연과 전어축제 노래자랑 등 계절별 테마 행사를 망라한다. 특히 각 행사의 구체적인 시작 시간과 종료 시간을 분 단위로 명시하고, 무료 또는 유료 여부와 구체적인 요금 체계를 수록하여 사용자의 방문 계획 수립에 실질적인 도움을 준다. 주관 및 주최 기관의 연락처 정보를 병기함으로써 행사 관련 세부 문의나 협의가 필요한 사용자들에게 직접적인 소통 창구를 제공하며, 지번 주소와 도로명 주소를 동시에 지원하여 행사장의 정확한 위치 파악이 가능하다.이 서비스는 관광 앱 개발자, 여행 작가, 지역 축제 기획자 및 보성군 방문객들에게 신뢰도 높은 최신 행사 정보를 제공하는 데 그 목적이 있다. 공공데이터 오픈 API 표준 규격을 준수하여 설계되었으며, 사용자는 이를 활용해 실시간 축제 알림 서비스를 구축하거나 지역 관광 지도를 제작하는 등 다양한 분야에서 부가가치를 창출할 수 있다. 보성군은 본 API를 통해 지역 문화 자산의 홍보 효과를 극대화하고 데이터 기반의 스마트 관광 인프라를 실현함으로써 지역 경제 활성화에 기여하고자 한다.

body header item items 결과메세지 결과코드 관리기관전화번호 데이터기준일자 소재지도로명주소 소재지지번주소 요금 요금정보 장소 전체 결과 수 주관기관 주최기관 페이지번호 한 페이지 결과 수 행사구분 행사내용 행사명 행사시작시각 행사시작일자 행사종료시각 행사종료일자

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '계획과 일정에 따라 많은   사람이 모이거나 참여하여 치르는 일을 끝마친 날짜=20260101' \
  --data-urlencode '계획과 일정에 따라 많은   사람이 모이거나 참여하여 치르는 일을 시작한 날짜=20260101' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '공연행사의 명칭=값' \
  --data-urlencode '데이터 작성 기준일자=20260101' \
  --data-urlencode '무료/유료=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "계획과 일정에 따라 많은   사람이 모이거나 참여하여 치르는 일을 끝마친 날짜": "20260101",
  "계획과 일정에 따라 많은   사람이 모이거나 참여하여 치르는 일을 시작한 날짜": "20260101",
  "공공데이터포털에서 받은 인증키": "값",
  "공연행사의 명칭": "값",
  "데이터 작성 기준일자": "20260101",
  "무료/유료": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "계획과 일정에 따라 많은   사람이 모이거나 참여하여 치르는 일을 끝마친 날짜": "20260101",
    "계획과 일정에 따라 많은   사람이 모이거나 참여하여 치르는 일을 시작한 날짜": "20260101",
    "공공데이터포털에서 받은 인증키": "값",
    "공연행사의 명칭": "값",
    "데이터 작성 기준일자": "20260101",
    "무료/유료": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())