Logo
Section 1 / 6

事件

学习如何使用 SeatGeek API 搜索实时活动。

导入

事件

学习如何使用 SeatGeek API 搜索实时活动。

  • 使用特定搜索参数获取分页的活动列表。
  • 通过提供具体的活动 `id` 获取特定活动的详细信息。
Course Image

名称描述
type该参数表示活动类型。
id该参数表示活动的唯一标识符。
datetime_utc该参数表示活动在 UTC 时区的时间安排。
venue该参数表示活动场馆的响应文档。
performers该参数表示活动表演者的响应文档列表。
is_open布尔类型参数，用于定义活动是否开放。
datetime_local该参数表示活动在本地时区的时间安排。
time_tbd布尔类型参数，用于定义活动时间是否尚未确定。当此参数为 true 时，datetime 参数中的日期为正确值，时间部分为占位符值。
stats该参数表示活动门票列表的相关统计数据。
taxonomies该参数表示活动分类的响应文档列表。
url该参数表示活动门票在 SeatGeek 预订页面的链接。
score该参数表示活动的热度评分，SeatGeek 根据活动的售票情况计算得出。
announce_date该参数表示活动公开宣布的日期。
date_tbd布尔类型参数，用于定义活动日期是否尚未确定。当此参数为 true 时，datetime 参数中的日期和时间均为占位符值。
title该参数表示活动标题。
popularity该参数表示活动的数值热度值，SeatGeek 根据活动的售票情况计算得出。

代码示例

1"https://api.seatgeek.com/2/events"

名称类别语法描述
ID可选id此参数通过唯一的活动 ID 获取特定活动。可以在同一 API 请求中多次使用 id 参数。该参数的默认值为 null。使用此参数时，所有其他 URL 参数将被覆盖，SeatGeek API 会忽略传入的其他参数，即使它们存在于 HTTP 请求中。
表演者可选performers.{FIELD}performers[{SPECIFICITY}].{FIELD}此参数根据特定表演者参数过滤活动结果。performers 参数支持两个字段：id 和 slug，可在同一 API 请求中互换使用。performers 参数支持以下 specificity 值：home_team、away_team、primary 和 any。使用 primary specificity 可查找具有热门表演者的活动。可以使用逗号分隔的表演者 ID 列表来根据特定表演者过滤活动结果。performers.{FIELD} 的默认值为 null；若使用 performers 参数，则 performers[{SPECIFICITY}].{FIELD} 的默认值为 any。
场馆可选venue.{OPERATOR}此参数根据特定场馆参数过滤活动结果。venue 参数支持我们在 venues 端点中使用的所有 URL 参数，例如 venue.city、venue.id 或 venue.state。可以使用逗号分隔的场馆 ID 列表来根据特定场馆过滤活动结果。
时间可选datetime_utcdatetime_utc.{OPERATOR}datetime_localdatetime_local.{OPERATOR}此参数根据特定日期和时间范围过滤活动结果。在同一 API 调用中最多可使用两次 datetime 参数。datetime 参数有两种类型：datetime_utc 和 datetime_local，功能相同，区别仅在于分别对应 UTC 时区和本地时区。该参数接受 ISO 8601 时间字符串格式（YYYY-MM-DDTHH:MM:SS）或 YYYY-MM-DD。datetime 参数支持以下操作符：gt、gte、lt 和 lte。该参数的默认值为 null。
查询可选q此参数通过查找响应文档的所有可能部分，对活动进行广泛搜索。由于这是一个广义搜索，返回的结果可能不符合预期。该参数的默认值为 null。
分类可选taxonomies.{FIELD}此参数通过分类信息根据特定活动类型过滤活动结果。taxonomy 参数支持我们在 taxonomies 端点中使用的所有 URL 参数。taxonomies 参数支持以下字段值：name、id 和 parent_id。该参数的默认值为 null。
1from requests import get, auth
2from json import loads, dumps
3
4# 预定义的密钥在此处显示
5CLIENT_ID = "{{CLIENT_ID}}"
6
7# 定义端点 URL
8endpoint_url = "https://api.seatgeek.com/2/events"
9
10# 定义认证信息
11url_auth = auth.HTTPBasicAuth(CLIENT_ID,"")
12
13# 定义请求参数
14url_parameters = {
15    'venue.city': 'NY',
16    'datetime_utc.gt': '2022-04-30',
17    'taxonomies.name': 'Sports',
18}
19
20# 定义向 SeatGeek API 发起请求的函数
21def make_api_call(url, auth, params):
22    # 发送 GET 请求
23    res = get(url=url, auth=auth, params=params)
24
25    # 检查 API 是否返回错误
26    if res.status_code != 200:
27        # 打印自定义错误信息
28        print_status(res)
29        return
30
31    # 打印格式化的 JSON 响应
32    parsed_json = loads(res.content)
33    formatted_json = dumps(parsed_json, indent=4)
34    print(formatted_json)
35
36# 调用 API
37make_api_call(endpoint_url, url_auth, url_parameters)

代码示例

1# 将 id 参数作为路径参数传递
2"https://api.seatgeek.com/2/events/{EVENT_ID}"

名称类别语法描述
ID必填id此参数通过唯一的活动 ID 获取特定活动。
1from requests import get, auth
2from json import loads, dumps
3
4# 预定义的密钥在此处显示
5CLIENT_ID = "{{CLIENT_ID}}"
6EVENT_ID = "{{EVENT_ID}}"
7
8# 定义端点 URL
9endpoint_url = f"https://api.seatgeek.com/2/events/{EVENT_ID}"
10
11# 定义认证信息
12url_auth = auth.HTTPBasicAuth(CLIENT_ID,"")
13
14# 定义向 SeatGeek API 发起请求的函数
15def make_api_call(url, auth):
16    # 发送 GET 请求
17    res = get(url=url, auth=auth)
18
19    # 检查 API 是否返回错误
20    if res.status_code != 200:
21        # 打印自定义错误信息
22        print_status(res)
23        return
24
25    # 打印格式化的 JSON 响应
26    parsed_json = loads(res.content)
27    formatted_json = dumps(parsed_json, indent=4)
28    print(formatted_json)
29
30# 调用 API
31make_api_call(endpoint_url, url_auth)

简介

表演者