Search · GET

Search suggestions

GET /search_suggestions

About

Search suggestions is a GET endpoint in the Search group of the Spotify Data API. It takes 8 parameters: q (required), plus offset, limit, numberOfTopResults, includeAuthors, debug, timeout and contrast (optional). No recorded sample exists for it; press Run to fetch a live response.

Parameters 8

q Required
In
query
Default
—
offset Optional
In
query
Default
0
limit Optional
In
query
Default
30
numberOfTopResults Optional
In
query
Default
30
includeAuthors Optional
In
query
Default
true
debug Optional
In
query
Default
false
timeout Optional
In
query
Default
30000
contrast Optional
In
query
Default
—
Description
Comma-separated list of streaming providers to contrast against. Appends a `_contrast` field to the response with cross-platform matching data. Available providers: `ytmusic`, `applemusic`, `amazonmusic`, `tencentmusic`, `pandora`, `gaana`.

Request

Against https://spotify-proxy.checkleaked.cc, with the same example values the Run button sends.

Sample response

Live only

This endpoint has no recorded sample. Press Run to fetch a real response.

Errors

400
“q” is required — a request that omits it, or sends a value of the wrong type, is rejected before it reaches Spotify.
401 / 403
The key is missing, wrong, or on a plan that does not include this endpoint. On RapidAPI the header is X-RapidAPI-Key; on the Direct Portal it is an Authorization: Bearer token; on Apify the actor supplies it.
429
Rate limited. The demo on this site allows 100 requests per 15 minutes and 500 per day per visitor, inside a budget shared by every visitor. With a key it is 5 requests per second on every RapidAPI plan and 10 per second on the Direct Portal.
5xx
Spotify itself failed or timed out. These are transient; retry once with a short backoff rather than immediately.

Related endpoints

The other 4 operations in the Search group.