Logo
Section 1 / 2

搜索 Spotify 资源

学习如何搜索关于艺术家、播放列表、专辑、节目或剧集的信息。

导入

搜索 Spotify 资源

学习如何搜索关于艺术家、播放列表、专辑、节目或剧集的信息。

该端点允许我们搜索任何艺术家、专辑、歌曲、播客或节目集的信息。此端点的基础 URI 为 https://api.spotify.com/v1/search，返回 Spotify 上可获取的相关信息。该端点还会提供可用于其他需要 Spotify ID 的接口的 Spotify ID。

查询参数类别类型描述
q必需字符串指定要通过此端点搜索的内容。
type必需字符串指定要搜索的类别。可能的选项包括：album（专辑）、artist（艺术家）、playlist（播放列表）、track（歌曲）、show（播客）、episode（节目集）。也可以通过逗号（,）分隔多个类别。
include_external可选字符串决定用户是否可以播放外部托管的音频。其有效值为 audio，表示允许播放外部托管音频。默认情况下，不允许播放外部音频。
limit可选整数限制响应中返回的项目数量。取值范围为 0 到 50，默认值为 20。
market可选字符串使用 ISO 3166-1 alpha-2 国家代码，用于仅获取特定国家可用的内容。例如，us 表示美国，es 表示西班牙，fr 表示法国。如果在请求头中发送了授权码访问令牌，则用户的国家将优先于本参数指定的国家。
offset可选整数用于偏移响应中的第一个项目。
1url = ('https://api.spotify.com/v1/search?'
2       'q=metallica&'
3       'type=artist')
4
5headers = {
6    'Content-Type': 'application/json',
7    'Authorization': 'Bearer {{CLIENT_CREDENTIALS_ACCESS_TOKEN}}'
8}
9
10response = requests.request("GET", url, headers=headers)
11print(json.dumps(response.json(), indent=4))
1url = ('https://api.spotify.com/v1/search?'
2       'q=jake&'
3       'type=artist')
4
5headers = {
6    'Content-Type': 'application/json',
7    'Authorization': 'Bearer {{AUTHORIZATION_CODE_ACCESS_TOKEN}}'
8}
9
10response = requests.request("GET", url, headers=headers)
11print(json.dumps(response.json(), indent=4))
响应字段类型描述
genres字符串数组包含该艺术家参与过的音乐流派。
name字符串艺术家名称。
popularity整数表示艺术家在 Spotify 上的受欢迎程度，取值范围为 0 到 100，100 为最热门。
images对象数组包含艺术家图像的相关信息。数组中的每个对象包含三个元素：图像的 URL、高度和宽度。
id字符串艺术家的 Spotify ID。
next字符串下一页的链接。
previous字符串上一页的链接。
total整数表示响应中返回的艺术家总数。

简介

最新发布