모든 축제들에 대한 컨텐츠 결과를 외부 개발자 및 사용자에게 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 |
콜백함수(output이 json일 경우) |
출력 결과(Response Element)
| 출력 변수 |
값 |
설명 |
| title |
string |
검색 제목 |
| totalcount |
integer |
전체 검색 결과의 수 |
| result |
integer |
한 페이지에 보여질 결과 수 |
| result |
integer |
한 페이지에 보여질 결과 수 |
| pageno |
integer |
검색 결과의 페이지 번호 |
| q |
string |
검색어 |
| item |
- |
개별 검색 결과 정보(아래에 설명) |
item
| 출력 변수 |
값 |
설명 |
| thumbnail_L |
- |
썸네일(Large) |
| thumbnail_S |
- |
썸네일(Small) |
| festival_name |
- |
축제명 |
| festival_synonym |
- |
축제명 동의어 |
| festival_homepage |
- |
공식 홈페이지 |
| local_depth1 |
- |
지역명1 depth |
| local_code |
- |
지역명 코드 |
| local_depth2 |
- |
지역명2 depth |
| local_depth1_synonym |
- |
지역명1 depth 동의어 |
| local_depth2_synonym |
- |
지역명2 depth 동의어 |
| start_month |
- |
개최월 |
| start_date |
- |
시작일 |
| end_date |
- |
종료일 |
| location |
- |
장소 |
| transportation |
- |
교통안내 |
| festival_intro |
- |
소개 |
| related_info1 |
- |
관련정보1 |
| related_info2 |
- |
관련정보2 |
| related_info3 |
- |
관련정보3 |
| related_info4 |
- |
관련정보4 |
| related_info5 |
- |
관련정보5 |
| theme |
- |
테마 |
| theme_synonym |
- |
테마동의어 |
| season |
- |
계절 |
| place_datakey |
- |
장소데이터키 |
| place_name |
- |
장소명 |
| coord_x |
- |
x좌표 |
| coord_y |
- |
y좌표 |
| place_id |
- |
장소ID |
| place_image |
- |
장소이미지 |
| start_year |
- |
개최연도 |
출력 방식
오류 메시지
표준 오류 메시지를 전달합니다.
트래픽 제한
1개의 키에 대해 하루 5,000회 호출을 허용합니다.
예제 코드
Daum 오픈API는 각 언어별 아래 예제를 통해 이용하실 수 있습니다.
