행사 찾기
search_events날짜, 지역, 검색어로 공개 행사를 찾습니다. 날짜를 비우면 이번 주말(한국 시간) 행사를 찾습니다. 결과가 limit보다 많으면 nextOffset을 offset에 넣어 이어서 받습니다. 검색어가 든 행사가 없으면 뜻이 비슷한 말로 한 번 더 찾고, 그때 쓴 말을 related에 적습니다.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | 지역 이름. 시·도(서울, 부산)나 시·군·구(마포구, 전주시)를 넣습니다. | |
| free | No | true면 무료 행사만, false면 유료 행사만 찾습니다. 비우면 요금을 따지지 않습니다. | |
| tags | No | 이 태그가 모두 붙은 행사만 찾습니다. 태그는 행사 글에 적힌 말에서 읽은 것이라, 없으면 "아님"이 아니라 "모름"입니다. 쓸 수 있는 이름: kids, family, teens, adults, seniors, pets, indoor, outdoor, watch, hands-on, food, market, walk, learn, heritage, nature, science, lights, fireworks, books, seasonal, halloween, christmas, year-end, new-year, evening, free, partly-paid, paid, book-ahead, walk-in. | |
| limit | No | 한 번에 받을 최대 개수. 1부터 50까지이고 기본값은 20입니다. | |
| query | No | 행사 이름, 장소, 분야, 주최에서 찾을 낱말. | |
| offset | No | 앞에서 건너뛸 개수. 이전 결과의 nextOffset을 넣으면 다음 묶음을 받습니다. 기본값은 0입니다. | |
| endDate | No | 끝 날짜(YYYY-MM-DD). 비우면 시작 날짜 하루만 찾고, 시작 날짜도 비었으면 이번 주말 마지막 날까지 찾습니다. | |
| startDate | No | 시작 날짜(YYYY-MM-DD). 비우면 이번 주말 첫날입니다. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | ||
| range | Yes | 찾은 날짜 범위(한국 시간). endDate가 null이면 끝을 정하지 않은 것이고, includePast=1로 찾으면 range 자체가 null입니다. | |
| total | Yes | 조건에 맞는 행사 전체 개수. | |
| events | Yes | ||
| offset | Yes | ||
| related | No | 검색어가 든 행사가 없어서 뜻이 비슷한 말로 다시 찾았을 때만 붙습니다. events는 groups의 묶음마다 한 낱말 이상이 맞는 행사입니다. | |
| coverage | Yes | 모아 둔 자료의 날짜 범위와 마지막 수집 시각. stale이 true면 저장소 대신 예비 사본에서 읽은 자료입니다. | |
| returned | Yes | ||
| nextOffset | Yes | 다음 묶음을 받을 때 offset에 넣을 값. 남은 행사가 없으면 null입니다. |