Logo
Section 1 / 4

查找事件

学习如何使用Ticketmaster的Discovery API查找和筛选事件。

导入

查找事件

学习如何使用Ticketmaster的Discovery API查找和筛选事件。

...
事件端点

代码示例

1https://app.ticketmaster.com/discovery/v2/events

参数类型分类说明
id字符串可选若提供，搜索结果将按事件 ID 进行过滤。
keyword字符串可选用于搜索的关键字。
attractionId字符串可选若提供，搜索结果将按演出项目 ID 进行过滤。
venueId字符串可选若提供，搜索结果将按场馆 ID 进行过滤。
startDateTime字符串可选若提供，搜索结果将返回开始日期在此时间之后的活动。
endDateTime字符串可选若提供，搜索结果将返回开始日期在此时间之前的活动。
size数字可选每页返回的结果数量，默认值为 20。
page数字可选返回搜索结果的页码，默认值为 0。
sort字符串可选搜索结果的排序方式。允许的值包括：name,asc、name,desc、date,asc、date,desc、relevance,asc、relevance,desc、distance,asc、name,date,asc、name,date,desc、date,name,asc、date,name,desc、distance,date,asc、onSaleStartDate,asc、id,asc、venueName,asc、venueName,desc、random。默认值为 relevance,desc。
classificationId字符串数组可选若提供，搜索结果将按分类 ID 进行过滤，即任何类别、流派、子流派、类型、子类型的 ID。支持负向过滤，格式为“-”。（负向过滤可能导致性能下降。）

属性类型说明
_embedded对象_embedded 对象包含一个名为 events 的属性，其值为一个对象数组，每个对象代表一个事件。默认情况下，事件按相关性降序排列。
_links对象_links 对象包含指向搜索结果中第一页、下一页、最后一页以及当前页的链接。
page对象page 对象包含关于搜索结果分页的信息，包括每页大小、总结果数、总页数和当前页码。

我们知道，搜索结果通常以多页形式返回，就像 Google 搜索结果那样。

单次 API 调用返回的响应对象代表搜索结果中的某一页——默认为第一页。每页的结果数量由查询参数 size 定义，默认值为 20。

Course Image
1import json
2import requests
3
4api_key = '{{API_KEY}}'
5
6response = requests.get('https://app.ticketmaster.com/discovery/v2/events',
7                        params = {
8                            'apikey' : api_key
9                        }).json()
10
11print(json.dumps(response, indent=4))
1import json
2import requests
3
4api_key = '{{API_KEY}}'
5
6response = requests.get('https://app.ticketmaster.com/discovery/v2/events',
7                        params = {
8                            'apikey' : api_key,
9                            'size': 5
10                        }).json()
11
12print(json.dumps(response, indent=4))
1import json
2import requests
3
4api_key = '{{API_KEY}}'
5event_id = '{{EVENT_ID}}'
6
7response = requests.get('https://app.ticketmaster.com/discovery/v2/events',
8                        params = {
9                            'apikey' : api_key,
10                            'id' : event_id
11                        }).json()
12
13print(json.dumps(response, indent=4))
1keyword = 'concert'
2
3response = requests.get('https://app.ticketmaster.com/discovery/v2/events',
4                        params = {
5                            'apikey' : api_key,
6                            'keyword' : keyword
7                        }).json()
1import json
2import requests
3
4api_key = '{{API_KEY}}'
5
6page_one_response = requests.get('https://app.ticketmaster.com/discovery/v2/events',
7                        params = {
8                            'apikey' : api_key
9                        }).json()
10
11# 从 _links 属性中获取下一页的链接
12page_two_url = page_one_response['_links']['next']['href']
13
14# 构造下一页的完整 URL
15page_two_url = 'https://app.ticketmaster.com' + page_two_url
16
17# 获取搜索结果的下一页
18page_two_response = requests.get(page_two_url, params = {'apikey' : api_key}).json()
19
20print(json.dumps(page_two_response, indent=4))

简介

搜索演出项目