Ticketmaster.com Scraper

Search events, attractions, venues, and classifications from the Ticketmaster Discovery API.

原始信息汇总

数据集概述：Ticketmaster.com Scraper

该API基于Ticketmaster Discovery API v2，提供对Ticketmaster官方活动目录的访问，无需自行爬取。它作为一个代理服务运行，开箱即用，并共享一个免费API密钥。

核心功能与能力

• 无需立即注册API密钥：开箱即用共享免费密钥。用户也可通过 ?apiKey= 参数传入在 developer.ticketmaster.com 注册的免费密钥，以获得专属配额。
• 提供九个端点：涵盖事件、搜索、按活动/场馆筛选、活动/场馆详情、分类等。
• 丰富筛选器：支持关键词、城市、州、国家、日期范围、流派、活动ID、场馆ID、排序和分页。
• 数据来源官方：数据来自Ticketmaster Discovery API v2，与Ticketmaster.com同源。

端点与返回内容

端点	返回内容
GET /events	浏览事件，支持可选筛选
GET /events/search	跨事件进行全文关键词搜索
GET /events/attraction	特定活动（艺人/团队）的所有事件，需提供活动ID
GET /events/venue	特定场馆的所有事件，需提供场馆ID
GET /attractions	按名称或流派搜索活动（艺人、团队等）
GET /attractions/{id}	单个活动详情，需提供ID
GET /venues	搜索Ticketmaster场馆目录
GET /venues/{id}	单个场馆详情，需提供ID
GET /classifications	完整的流派和分类体系

重要参数与使用示例

共享通用参数：所有端点均可选 apiKey（用于输入个人免费密钥），省略则使用共享密钥。

快速开始示例：

• GET /events?city=Los+Angeles&genre=Rock
• GET /events/search?q=Coldplay
• GET /events/attraction?attractionId=K8vZ9171oa0
• GET /classifications

事件对象输出字段示例（所有事件端点）：

• _embedded.events[].id：Ticketmaster事件ID
• _embedded.events[].name：事件名称
• _embedded.events[].dates.start：开始日期时间
• _embedded.events[].url：Ticketmaster事件页面URL
• _embedded.events[].priceRanges：票价范围（最低/最高）
• _embedded.events[].classifications：流派和细分分类
• _embedded.events[]._embedded.venues：场馆对象（含名称、城市、州、国家）
• _embedded.events[]._embedded.attractions：活动对象（艺人/团队）
• page.totalElements：总匹配事件数
• page.totalPages：总页数

性能与缓存

端点	最大延迟	缓存TTL
/events, /events/search, /events/attraction, /events/venue	~2秒	1小时
/attractions, /attractions/{id}	~2秒	24小时
/venues, /venues/{id}	~2秒	24小时
/classifications	~2秒	24小时

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

错误码参考

状态码	含义
400	缺少必填参数（q、attractionId 或 venueId）
401	缺少或无效的RapidAPI密钥
404	在 GET /attractions/{id} 或 GET /venues/{id} 中的 attractionId 或 venueId 未知
503	共享Ticketmaster API密钥达到速率/每日限制（可通过 apiKey 提供个人密钥）
500	内部服务器错误

典型应用场景

• 音乐会发现应用
• 艺人巡演追踪器
• 场馆日历
• 票价监控
• 跨平台活动聚合
• 流派发现