Search for an Item
Developing
GET
/search
category-search
that match a keyword string.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.spotify.com/v1/search?q=&type=' \
--header 'Authorization;'Response Response Example
200 - Example 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
}
}Request
Query Params
q
string
required
For example:
q=roadhouse%20blues.type
string
required
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
string
optional
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
integer
optional
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
integer
optional
Default: 0 (the first result).
Maximum offset (including limit): 1,000.
Use with limit to get the next page of search results.
include_external
string
optional
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 Params
Authorization
string
required
Responses
Modified at 2022-09-12 10:04:50