Search for an Item

Developing

GET

/search

Get Spotify Catalog information about albums, artists, playlists, tracks, shows or episodes
that match a keyword string.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/search?q=&type=' \
--header 'Authorization;'

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

Header Params

Responses

🟢200**On success**: - In the response ***header*** the HTTP status code is `200` OK. - For each type provided in the `type` parameter, the response ***body*** contains an array of [artist objects](https://developer.spotify.com/documentation/web-api/reference

application/json

Body

🔴500500

Modified at 2022-09-12 10:04:50

Get a User's Top Artists and Tracks

Get Multiple Shows