通过活动短名称或链接查询 Yelp 活动详情
查看 Yelp 商家、评论与餐厅数据 的全部接口 →使用必填的 event 字符串查询单个 Yelp 活动的详情。可传入 huntington-beach-oktoberfest-on-thursdays-4 这样的活动短名称（slug），也可传入 Yelp 活动链接。此接口用于查询某一场活动，不用于搜索城市中的活动。 文档描述的内容包括活动介绍、开始和结束时间、场地地址、价格及感兴趣人数。这些仅是文档说明，并非已观测到的响应字段：目前没有此接口的实测响应，提供的 HTTP 200 示例也是空对象。因此，具体 JSON 键名、嵌套结构、数据类型和字段是否可选均未验证。 活动时间和价格应以实际返回的信息为准，不要推断缺失的时区、币种或门票余量。感兴趣人数仅代表关注意向，不代表确认出席人数。获得活动详情也不意味着可以完成预订或购票。
API 功能
按活动短名称或链接定位 通过必填的 event 参数传入活动短名称或 Yelp 活动链接，定位单场活动，无需提供城市筛选条件。
为活动详情卡补充介绍 文档说明详情内容包含活动介绍，可用于丰富已选活动的展示卡片；现有空对象示例无法确认对应的 JSON 字段名称。
核对活动起止时间 文档描述了开始和结束时间，可在实际返回时用于核对日程。应保留返回的时区信息，缺失时区时不作推断。
参考场地、价格与关注意向 文档描述的详情包括场地地址、价格和感兴趣人数，但这些信息是否返回及其具体结构尚未验证，感兴趣也不等于确认出席。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/yelp/event-details API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/event-details?key=<API_KEY>&event=huntington-beach-oktoberfest-on-thursdays-4'
curl -X GET 'https://api.opendata-api.com/api/project/yelp/event-details?key=<API_KEY>&event=huntington-beach-oktoberfest-on-thursdays-4'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 编辑从城市活动列表中选定活动后，使用实际返回的介绍、日程和场地地址补充城市指南的活动详情卡。
- 根据返回的开始和结束时间制作需人工审核的日历导出内容，保留已有时区信息，对缺失时区作出标记而非猜测。
- 用活动列出的场地地址和价格整理出行简报，缺失费用或币种时保留待核实状态，并另行确认门票是否可购。
- 将返回的感兴趣人数作为关注意向指标，为编辑的活动审核队列排序，不将其标注为出席人数或售票总量。
常见问题
event 参数应该填写什么？
填写 Yelp 活动短名称（slug），例如 huntington-beach-oktoberfest-on-thursdays-4，或 Yelp 活动链接。event 是必填字符串，用于标识单场活动，而非搜索城市或场地。
文档列出了哪些活动详情？响应字段是否经过验证？
文档描述了活动介绍、开始和结束时间、场地地址、价格及感兴趣人数。目前没有此接口的实测响应，提供的 HTTP 200 示例为空对象，因此具体 JSON 键名、类型、嵌套结构及字段是否可选均未验证。
能否默认活动时间包含时区、价格包含币种？
不能。现有示例无法确认时区和币种字段。应保留实际返回的信息，在导出日历或展示价格之前，将缺失信息标记为待核实。
感兴趣人数能否证明实际出席人数或门票仍有余量？
不能。感兴趣人数只能作为关注意向指标。此活动查询不能确认实际出席人数、门票库存或是否能够购票。