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
必需