Vividseats.com Scraper

Browse and search Vivid Seats events by keyword, performer, venue, or category. No API key required.

原始信息汇总

Vividseats.com Scraper 数据集概述

API 地址：https://rapidapi.com/hoholabs/api/vividseats-com-scraper

API 版本：1.0.0 (当前)

功能简介
该 API 用于浏览和搜索 Vivid Seats 平台上的活动信息，支持按关键词、表演者、场馆或类别进行查询，无需 Vivid Seats 账户或 API 密钥，返回干净的 JSON 格式数据。

---

核心特点

• 无需管理凭证：无需上游 API 密钥。
• 多种查询模式：浏览全部活动、按名称搜索、按表演者或场馆筛选。
• 表演者 & 场馆目录：支持通过 ID 查询特定表演者或场馆的所有活动。
• 广泛的活动目录：涵盖音乐会、体育赛事、戏剧等北美地区活动。

---

可用端点

端点	功能说明
GET /events	浏览活动（支持可选过滤器）
GET /events/search	按艺人/球队/场馆名称搜索，解析出最佳匹配并返回其全部活动
GET /events/performer	根据表演者 ID 获取其所有活动
GET /events/venue	根据场馆 ID 获取该场馆所有活动
GET /performers	表演者目录，按名称搜索查找表演者 ID
GET /venues	场馆目录

---

常用参数

共享过滤器（适用于 /events、/events/search、/events/performer、/events/venue）

参数	类型	描述
dateFrom	string	开始日期，格式 YYYY-MM-DD
dateTo	string	结束日期，格式 YYYY-MM-DD
sort	string	排序方式：date、name、price 或 rank（默认）
rows	integer	每页结果数
start	integer	分页偏移量

GET /events/search 必要参数

参数	是否必需	描述
q	是	艺人、球队或场馆名称（如 Taylor Swift、Lakers）

GET /events/performer 必要参数

参数	是否必需	描述
performerId	是	数值型 Vivid Seats 表演者 ID

GET /events/venue 必要参数

参数	是否必需	描述
venueId	是	数值型 Vivid Seats 场馆 ID

---

输出字段（活动端点）

字段	描述
items	活动对象数组
items[].id	Vivid Seats 活动 ID
items[].name	活动名称
items[].localDate	活动当地日期/时间（ISO 8601）
items[].utcDate	活动 UTC 日期/时间（ISO 8601）
items[].venue.name	场馆名称
items[].venue.city	城市
items[].venue.state	州
items[].venue.countryCode	国家代码（如 US）
items[].minPrice	最低可用票价
items[].maxPrice	最高可用票价
items[].listingCount	活跃票务列表数量
items[].ticketCount	可用票数
items[].performers	演出者列表
items[].webPath	Vivid Seats 活动页面路径
page	当前页码
total	结果总数
numberOfPages	总页数

---

延迟与缓存

端点	最大延迟	缓存 TTL
/events、/events/search、/events/performer、/events/venue、/performers	~2 秒	1 小时
/venues	~2 秒	24 小时

在 TTL 内的后续请求将直接从缓存返回。

---

错误码

状态码	含义
400	缺少必要参数（q、performerId 或 venueId）
401	缺少或无效的 API 密钥
500	服务器内部错误

---

使用场景

• 票价监控：跟踪活动最低票价随时间变化。
• 活动发现应用：浏览音乐、体育、戏剧等活动。
• 艺人巡演跟踪：通过表演者 ID 拉取其全部即将举办的活动。
• 场馆日历：获取特定场馆的完整活动日程。
• 可用性提醒：监控票数以检测售罄风险。