Spotify Search API

Search for artists, albums, tracks, and playlists using the Spotify API. This endpoint is a proxy to the official Spotify Search API.

Endpoint

GET https://api.recoupable.com/api/spotify/search

Parameters

Name	Type	Required	Description
q	string	Yes	The search query keywords and optional field filters.
type	string	Yes	A comma-separated list of item types to search across: album, artist, etc.
market	string	No	An ISO 3166-1 alpha-2 country code or "from_token".
limit	int	No	Maximum number of results to return (default: 20, min: 1, max: 50).
offset	int	No	The index of the first result to return (default: 0, max: 10,000).

Supported types: album, artist, playlist, track, show, episode, audiobook

Request Examples

cURL

curl -X GET "https://api.recoupable.com/api/spotify/search?q=radiohead&type=artist" \
  -H "Content-Type: application/json"

Example Response

{
  "artists": {
    "href": "https://api.spotify.com/v1/search?query=radiohead&type=artist&offset=0&limit=2",
    "items": [
      {
        "external_urls": {
          "spotify": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb"
        },
        "followers": { "href": null, "total": 5000000 },
        "genres": ["alternative rock", "rock"],
        "id": "4Z8W4fKeB5YxbusRsdQVPb",
        "images": [
          {
            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",
            "height": 300,
            "width": 300
          }
        ],
        "name": "Radiohead",
        "popularity": 85,
        "type": "artist",
        "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb"
      }
    ],
    "limit": 2,
    "next": "https://api.spotify.com/v1/search?query=radiohead&type=artist&offset=2&limit=2",
    "offset": 0,
    "previous": null,
    "total": 1
  }
}

Response Properties

Property	Type	Description
artists	object	Search results for artists (if type includes artist)
artists.items	array	List of artist objects
artists.items[].id	string	Spotify artist ID
artists.items[].name	string	Artist name
artists.items[].type	string	Always "artist"
artists.items[].uri	string	Spotify URI for the artist
artists.items[].external_urls	object	External URLs, including Spotify web link
artists.items[].images	array	Array of image objects (url, height, width)
artists.items[].popularity	int	Popularity score (0-100)
artists.items[].genres	array	List of genres
artists.items[].followers	object	Follower info (total, href)
artists.limit	int	Max results returned
artists.offset	int	Index of first result
artists.total	int	Total number of results
artists.next	string	URL to next page of results (if any)
artists.previous	string	URL to previous page of results (if any)

See the Spotify Search API Reference for full details on all item types and fields.

Notes

This endpoint requires a valid Spotify access token (handled by the Recoup API backend).
You can search for multiple types at once (e.g., type=artist,album).
Results are paginated; use limit and offset for navigation.
For more details, see the official Spotify Search API documentation.