축제 컨텐츠 API는 모든 축제들에 대한 컨텐츠 결과를 외부 개발자 및 사용자에게 XML, JSON, RSS 형식으로 전달하는 API 서비스입니다. 축제들에 대한 정보를 자신의 블로그나 자사 웹 서비스에 제공할 수 있게 해 줍니다.
요청 주소(Request URL) #
http://apis.daum.net/contents/festival
요청 변수(Request Parameters) #
| 요청 변수 | 값 | 설명 |
| apikey | string(필수) | 모든 오픈API 요청에 반드시 필요한 인증키입니다. https일반 사용자 등록을 통해 발급받으실 수 있습니다. |
| q | String(필수) | 검색을 원하는 질의 |
| result | Integer:기본값10, 최소 1, 최대 20 | 한 페이지에 출력될 결과 수 |
| pageno | Integer:기본값1, 최소 1, 최대 500 | 검색 결과 페이지 번호 |
| output | String: xml(기본값), rss, json | 출력방식 |
| callback | String | 콜백함수 |
출력 결과(Response Elements) #
| 출력 변수 | 값 | 설명 |
| title | string | 검색 제목 |
| totalCount | integer | 전체 검색 결과의 수 |
| result | integer | 한 페이지에 보여질 결과 수 |
| pageno | integer | 검색 결과의 페이지 번호 |
| q | string | 검색어 |
| item | - | 개별 검색 결과 정보(아래에 설명) |
item #
| 출력 변수 | 값 | 설명 |
| thumbnail_L | - | 썸네일(Large) |
| thumbnail_S | - | 썸네일(Small) |
| name | - | 축제명 |
| synonym | - | 축제명 동의어 |
| homepage | - | 공식 홈페이지 |
| area1 | - | 지역명 1depth |
| area2 | - | 지역명 2depth |
| area1_synonym | - | 지역명 1depth 동의어 |
| area2_synonym | - | 지역명 2depth 동의어 |
| date | - | 개최월 |
| start_date | - | 시작일 |
| end_date | - | 종료일 |
| location | - | 장소 |
| transport | - | 교통안내 |
| schema | - | 개요 |
| info1 | - | 관련정보1 |
| info2 | - | 관련정보2 |
| info3 | - | 관련정보3 |
| info4 | - | 관련정보4 |
| info5 | - | 관련정보5 |
| location_ino | - | 위치정보 |
| idx_date | - | 색인 날짜 |
| season | - | 계절 |
트래픽 제한 #
축제 컨텐츠 API는 하나의 키에 대해 하루 5,000회 호출을 허용합니다. 자세한 사항은
![[http]](/wiki/imgs/http.png)
트래픽 제한을 참조하세요.
예제 코드 #
Daum 오픈API는 각 언어별 아래 예제를 통해 이용하실 수 있습니다.
