Search for an Item
GET
/search
category-search
that match a keyword string.
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.spotify.com/search?q=&type=' \
--header 'Authorization;'响应示例响应示例
200 - 示例 1
{
"albums": {
"href": "string",
"items": [
{
"album_group": "string",
"album_type": "string",
"artists": [
{
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"name": "string",
"type": "string",
"uri": "string"
}
],
"available_markets": [
"string"
],
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"name": "string",
"release_date": "string",
"release_date_precision": "string",
"restrictions": {
"reason": "string"
},
"total_tracks": 0,
"type": "string",
"uri": "string"
}
],
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total": 0
},
"artists": {
"href": "string",
"items": [
{
"external_urls": {
"spotify": "string"
},
"followers": {
"href": "string",
"total": 0
},
"genres": [
"string"
],
"href": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"name": "string",
"popularity": 0,
"type": "string",
"uri": "string"
}
],
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total": 0
},
"episodes": {
"href": "string",
"items": [
{
"audio_preview_url": "string",
"description": "string",
"duration_ms": 0,
"explicit": true,
"external_urls": {
"spotify": "string"
},
"href": "string",
"html_description": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"is_externally_hosted": true,
"is_playable": true,
"language": "string",
"languages": [
"string"
],
"name": "string",
"release_date": "string",
"release_date_precision": "string",
"restrictions": {
"reason": "string"
},
"resume_point": {
"fully_played": true,
"resume_position_ms": 0
},
"type": "string",
"uri": "string"
}
],
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total": 0
},
"playlists": {
"href": "string",
"items": [
{
"collaborative": true,
"description": "string",
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"name": "string",
"owner": {
"display_name": "string",
"external_urls": {
"spotify": "string"
},
"followers": {
"href": "string",
"total": 0
},
"href": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"type": "string",
"uri": "string"
},
"public": true,
"snapshot_id": "string",
"tracks": {
"href": "string",
"total": 0
},
"type": "string",
"uri": "string"
}
],
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total": 0
},
"shows": {
"href": "string",
"items": [
{
"available_markets": [
"string"
],
"copyrights": [
{
"text": "string",
"type": "string"
}
],
"description": "string",
"explicit": true,
"external_urls": {
"spotify": "string"
},
"href": "string",
"html_description": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"is_externally_hosted": true,
"languages": [
"string"
],
"media_type": "string",
"name": "string",
"publisher": "string",
"type": "string",
"uri": "string"
}
],
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total": 0
},
"tracks": {
"href": "string",
"items": [
{
"album": {
"album_group": "string",
"album_type": "string",
"artists": [
{
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"name": "string",
"type": "string",
"uri": "string"
}
],
"available_markets": [
"string"
],
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"name": "string",
"release_date": "string",
"release_date_precision": "string",
"restrictions": {
"reason": "string"
},
"total_tracks": 0,
"type": "string",
"uri": "string"
},
"artists": [
{
"external_urls": {
"spotify": "string"
},
"followers": {
"href": "string",
"total": 0
},
"genres": [
"string"
],
"href": "string",
"id": "string",
"images": [
{
"height": 0,
"url": "string",
"width": 0
}
],
"name": "string",
"popularity": 0,
"type": "string",
"uri": "string"
}
],
"available_markets": [
"string"
],
"disc_number": 0,
"duration_ms": 0,
"explicit": true,
"external_ids": {
"ean": "string",
"isrc": "string",
"upc": "string"
},
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"is_local": true,
"is_playable": true,
"linked_from": {
"external_urls": {
"spotify": "string"
},
"href": "string",
"id": "string",
"type": "string",
"uri": "string"
},
"name": "string",
"popularity": 0,
"preview_url": "string",
"restrictions": {
"reason": "string"
},
"track_number": 0,
"type": "string",
"uri": "string"
}
],
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total": 0
}
}请求参数
Query 参数
q
必需
For example:
q=roadhouse%20blues.type
必需
Valid types are:
album , artist, playlist, track, show and episode.Search results include hits from all the specified item types.
For example:
q=name:abacab&type=album,track returns both albums and tracks with "abacab" included in their name.market
可选
from_token.If a country code is specified, only content that is playable in that market is returned.
Note :
from_token, and a valid access token is specified in the request header, only content playable in the country associated with the user account, is returned.user-read-private scope prior to when the access token is issued.limit
可选
Default: 20
Minimum: 1
Maximum: 50
Note : The limit is applied within each type, not on the total response.
For example, if the limit value is 3 and the type is
artist,album, the response contains 3 artists and 3 albums.offset
可选
Default: 0 (the first result).
Maximum offset (including limit): 1,000.
Use with limit to get the next page of search results.
include_external
可选
If include_external=audio is specified the response will include any relevant audio content that is hosted externally.
By default external content is filtered out from responses.
Header 参数
Authorization
必需
返回响应
修改于 2021-08-02 10:49:34