按城市、类别和日期范围搜索 Yelp 活动
查看 Yelp 商家、评论与餐厅数据 的全部接口 →使用必填的 city 字符串浏览 Yelp 活动列表，参数内容为 Yelp 活动页面的城市短名称（slug）或城市活动链接。可通过 category、start_date 和 end_date 缩小范围；传入字符串 official_only=true 可仅查询 Yelp 官方活动；还可设置 sort_by 排序方式和 page 页码。日期格式为 YYYY-MM-DD。文档给出的默认值为 official_only=false、sort_by=popular、page=1。 文档说明每页包含 15 场活动，并提供场地和开始时间信息。支持的页码范围为 1 至 100，但这不代表每页都有结果，也不保证覆盖城市中的全部活动。目前没有此接口的实测响应，提供的 HTTP 200 示例也是空对象。具体活动字段、列表嵌套结构、标识符字段、数据类型、数量信息和分页元数据均未验证。 应将结果作为来自 Yelp 的活动候选清单，而不是完整活动目录或门票余量数据源。选定活动后，可通过 event-details 接口传入活动短名称或链接查看详情；现有示例无法确认这些标识在搜索结果中的具体表示方式。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/search-events API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/search-events?key=<API_KEY>&city=sf&official_only=false&page=1&sort_by=popular'
查询结果
使用场景
- 按城市、类别和日期范围整理周末活动选题清单，再将选定活动的短名称或链接用于单场活动详情查询。
- 为城市指南收集社区活动候选，记录请求使用的 official_only 设置、页码和筛选条件，不承诺完整发现全城活动。
- 结合 kids_and_family 类别与学校假期日期范围准备亲子出游候选清单，在编辑发布前核对返回的场地和开始时间。
- 使用 recently_added 排序及 visual_arts 或 film 等类别审核新加入的文化活动候选，并记录已检查的列表页。
常见问题
city 参数支持哪些值？
可填写 Yelp 活动页面的城市短名称，例如 sf、la、nyc 或 chicago，也可填写 https://www.yelp.com/events/sf 这样的 Yelp 活动链接。文档未将必填的 city 参数定义为经纬度输入。
日期筛选如何使用？
start_date 设置最早活动日期，end_date 设置最晚活动日期，二者均为可选字符串，格式为 YYYY-MM-DD，例如 2026-10-01 和 2026-10-31。现有资料未说明是否包含边界日期或如何处理时区。
每页有多少场活动？支持哪些页码？
文档说明每页 15 场活动，默认页码为 1，允许的页码范围为 1 至 100。支持该范围不代表每页都有结果；响应中的总数或下一页字段尚未验证。
如何只查询 Yelp 官方活动？
将 official_only 设为字符串 true。文档给出的默认值是字符串 false；请求定义中此参数为字符串，而不是布尔类型。
sort_by=free 是否保证只返回免费活动？
文档没有作出这项保证。free 与 popular、recently_added 一样，都是允许的 sort_by 值，默认值为 popular。在将活动描述为免费之前，应核实实际返回的价格。
目前观测并验证了哪些搜索响应字段？
此接口尚无经过独立观测的响应字段。文档描述的活动列表包含场地和开始时间信息，但目前没有实测响应，提供的 HTTP 200 示例也是空对象。具体 JSON 键名、列表结构、活动标识符和分页元数据均未验证。