🎫 活动门票剪贴器(Ticketmaster)
Apify最全面、最可靠的活动刮票器-由官方Ticketmaster Discovery API提供动力
🌟 为什么选择这款刮刀?
Event Ticket Scraper通过以下高级功能提供生产就绪的事件搜索功能:
综合事件搜索:在Ticketmaster庞大的数据库中搜索音乐会、体育比赛、戏剧表演、喜剧、节日和任何现场活动。按关键字、城市、州、国家、邮政编码、地理坐标、日期范围、类型等过滤。
实时门票定价:从Ticketmaster的官方API获取当前价格范围(最小/最大)、货币、门票状态(正在销售/已取消/已推迟)、公开销售窗口和预售详细信息。
丰富的场地和艺术家数据:每个活动都包括完整的场地详细信息(名称、地址、城市、州、国家、GPS坐标、时区)、艺术家/景点名称、活动分类(分段>流派>子流派)、推广商信息、座位图和高分辨率图像。
多种搜索模式:按关键字搜索事件,按ID查找特定事件,或独立搜索场地。三种模式,一个演员。
免费API密钥:使用Ticketmaster的免费Discovery API(每天5000次呼叫,5次请求/秒)。无需付费订阅API-只需在developer.tticketmaster.com注册即可。
企业级可靠性:内置速率限制、429响应的指数回退、可配置的请求间隔、批量数据集推送和可恢复运行的Apify状态持久性。
🚀 特性
核心能力
- 三种搜索模式:事件搜索、按ID查找事件和场地搜索
- 强大的过滤器:关键字、城市、州、国家、邮政编码、纬度/长半径、日期范围、类型/分类、源平台、家庭友好
- 地理搜索:搜索任何GPS坐标或邮政编码半径内的事件
- 灵活排序:按相关性、日期(最快/最新)、姓名(A-Z/Z-A)或距离(最近的第一个)
- 深度分页:自动分页,每次搜索最多1000个结果
- 全球覆盖:美国、加拿大、英国、墨西哥和部分欧洲市场
数据质量
- 门票价格:每个活动的最低/最高价格范围和货币
- 预售英特尔:预售姓名、日期窗口和描述(已验证粉丝、花旗卡会员、VIP等)
- 场地详情:完整地址、城市、州、国家、邮政编码、GPS坐标和时区
- 分类层级:分段>流派>子流派(例如音乐>摇滚>另类摇滚)
- 富媒体:多种分辨率的座位地图图像、活动图像
- 直接链接:每个活动的购票URL
📖 用法示例
示例1:纽约音乐会搜索
搜索泰勒·斯威夫特在纽约市的演唱会。
{
"apiKey": "YOUR_API_KEY",
"mode": "search",
"keyword": "Taylor Swift",
"city": "New York",
"stateCode": "NY",
"countryCode": "US",
"classificationName": "Music",
"maxResults": 50
}示例2:具有日期范围的体育赛事
查找按日期排序的6月份NBA比赛。
{
"apiKey": "YOUR_API_KEY",
"mode": "search",
"keyword": "NBA",
"startDateTime": "2025-06-01T00:00:00Z",
"endDateTime": "2025-06-30T23:59:59Z",
"countryCode": "US",
"sort": "date,asc",
"maxResults": 100
}示例3:地理搜索——我附近的事件
查找曼哈顿25英里范围内的音乐活动。
{
"apiKey": "YOUR_API_KEY",
"mode": "search",
"latlong": "40.7128,-74.0060",
"radius": 25,
"unit": "miles",
"classificationName": "Music",
"sort": "distance,asc",
"maxResults": 50
}示例4:查找特定事件
获取已知Ticketmaster活动ID的完整详细信息。
{
"apiKey": "YOUR_API_KEY",
"mode": "get_event",
"eventId": "vvG1iZ4JFSmpkV"
}示例5:场地搜索
搜索洛杉矶的竞技场。
{
"apiKey": "YOUR_API_KEY",
"mode": "venues",
"keyword": "arena",
"city": "Los Angeles",
"stateCode": "CA"
}例6:喜剧节目——仅限家庭观看
在芝加哥寻找适合家庭观看的喜剧节目。
{
"apiKey": "YOUR_API_KEY",
"mode": "search",
"classificationName": "Comedy",
"city": "Chicago",
"stateCode": "IL",
"includeFamily": "yes",
"sort": "date,asc",
"maxResults": 25
}🔍 输入参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
apiKey | string | ✅ | - | Ticketmaster Discovery API密钥。免费获得一个 developer.tickemaster.com |
mode | string | ❌ | "search" | 操作模式: search, get_event,或 venues |
keyword | string | ❌ | - | 搜索词——艺术家、活动名称、团队或流派(例如。 "Taylor Swift", "NBA", "comedy") |
eventId | string | ❌ | - | Ticketmaster事件ID get_event 模式(例如。 "vvG1iZ4JFSmpkV") |
city | string | ❌ | - | 按城市名称筛选(例如。 "New York", "Los Angeles") |
stateCode | string | ❌ | - | 州/省代码(例如。 "NY", "CA", "ON") |
countryCode | string | ❌ | - | ISO Alpha-2国家代码(例如。 "US", "CA", "GB") |
postalCode | string | ❌ | - | 邮政编码(例如。 "10001") |
latlong | string | ❌ | - | 地理中心点为 "lat,long" (例如。 "40.7128,-74.0060").与...一起使用 radius |
radius | integer | ❌ | - | 从中心点开始的搜索半径,单位为英里或公里(1–500) |
unit | string | ❌ | "miles" | 半径单位: miles 或 km |
classificationName | string | ❌ | - | 事件类型/类型: "Music", "Sports", "Arts & Theatre", "Comedy", "Rock", "Pop", "NBA", "NFL"等等。 |
startDateTime | string | ❌ | - | 在此日期或之后开始的事件。ISO 8601格式: "YYYY-MM-DDTHH:mm:ssZ" |
endDateTime | string | ❌ | - | 在此日期或之前开始的事件。ISO 8601格式: "YYYY-MM-DDTHH:mm:ssZ" |
sort | string | ❌ | "relevance,desc" | 排序顺序: relevance,desc, date,asc, date,desc, name,asc, name,desc, distance,asc |
source | string | ❌ | - | 按来源筛选: ticketmaster, universe, frontgate, tmr |
includeFamily | string | ❌ | - | 家庭友好型过滤器: "yes" 或 "no" |
maxResults | integer | ❌ | 100 | 最大结果数(1-1000)。免费会员:每次25人 |
requestIntervalSecs | number | ❌ | 0.5 | API请求之间的最小秒数(0.2–5.0) |
📊 输出格式
事件输出
每个事件都作为一个单独的数据集项推送,其结构如下:
{
"schema_version": "1.0",
"type": "event",
"event_name": "Taylor Swift | The Eras Tour",
"event_id": "vvG1iZ4JFSmpkV",
"event_url": "https://www.ticketmaster.com/event/vvG1iZ4JFSmpkV",
"local_date": "2025-08-15",
"local_time": "19:00:00",
"datetime_utc": "2025-08-15T23:00:00Z",
"timezone": "America/New_York",
"status": "onsale",
"price_min": 49.5,
"price_max": 449.5,
"price_currency": "USD",
"venue_name": "Madison Square Garden",
"venue_id": "KovZpZA7AAEA",
"venue_city": "New York",
"venue_state": "New York",
"venue_country": "United States Of America",
"venue_address": "4 Pennsylvania Plaza",
"venue_postal_code": "10001",
"venue_latitude": 40.7505,
"venue_longitude": -73.9934,
"attractions": ["Taylor Swift"],
"segment": "Music",
"genre": "Pop",
"sub_genre": "Pop Rock",
"public_sale_start": "2025-01-15T15:00:00Z",
"public_sale_end": "2025-08-15T23:00:00Z",
"presales": [
{
"name": "Verified Fan Presale",
"start_date_time": "2025-01-13T15:00:00Z",
"end_date_time": "2025-01-14T23:00:00Z",
"description": "",
"url": ""
}
],
"promoter": "Live Nation",
"seatmap_url": "https://maps.ticketmaster.com/...",
"images": ["https://s1.ticketm.net/dam/a/..."],
"info": "",
"please_note": "No professional cameras or recording devices",
"ticket_limit": "There is a 4 ticket limit per household",
"accessibility_info": "",
"source": "ticketmaster",
"scraped_at": "2025-06-15T12:00:00+00:00"
}输出字段
event_name/event_id/event_url:核心活动识别和直接门票链接local_date/local_time/datetime_utc/timezone:完整的日期/时间信息status:当前票证状态--onsale,offsale,canceled,postponed,rescheduledprice_min/price_max/price_currency:票价范围- **
venue_***:完整的场地细节,包括GPS坐标 attractions:与活动相关的艺术家/团队名称segment/genre/sub_genre:事件分类层次结构presales:带有名称、日期和描述的预售窗口数组seatmap_url/images:活动的视觉资源
🔑 API密钥设置
这个演员需要一个 自由 Ticketmaster Discovery API密钥:
- 首选 developer.tickemaster.com
- 创建一个免费账户
- 复制您的 消费者密钥 从仪表板-这是您的API密钥
费率限制: 5000个电话/天 和 5个请求/秒。足够典型使用。
💰 定价
此演员使用 按事件付费 定价模型 每个结果0.0005美元 (即每1000个活动0.50美元)。
免费会员可获得 每次运行25个结果 免费。
🎯 用例
- 价格监控:跟踪特定活动、艺术家或场地随时间变化的门票价格范围
- 事件发现:查找任何城市或地区即将举行的音乐会、体育比赛、戏剧表演和节日
- 市场调研:分析不同场地、类型、地区或时间段的活动定价趋势
- 预售警报:监控预售日期和高需求活动的销售窗口
- 场馆情报:研究场地细节、地点和即将举行的活动数量
- 旅行计划:建立事件感知旅行推荐系统
- AI代理:通过MCP集成将实时事件和票务数据输入LLM管道
🤖 MCP集成
将此参与者用作AI代理管道中的工具。添加到MCP客户端配置中:
{
"mcpServers": {
"apify": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}然后问你的AI: *“查找泰勒·斯威夫特在纽约的演唱会门票价格”*
📝 备注
- 使用 官方Ticketmaster Discovery API --没有浏览器,没有剧作家,没有机器人检测问题
- Ticketmaster将深度分页限制为 每个搜索查询约1000个结果.使用筛选器缩小结果范围
- 价格数据为 最小/最大范围,而不是个人座位价格。不提供实时座位可用性
- 最佳地理覆盖范围 美国、加拿大、英国、墨西哥,并选择欧洲市场
- 所有日期必须在 带时区的ISO 8601格式 (例如。
2025-06-01T00:00:00Z) - 在一次运行中,结果会根据事件ID自动进行重复数据消除
- 演员支持 使状态持久化 用于可恢复的长时间搜索
制作❤️ 面向事件数据爱好者
*使用Apify上最可靠的Ticketmaster抓取器转换您的活动情报。*
