Search · GET
Search — top results only
GET /search_top_results
About
Search — top results only is a GET endpoint in the Search group of the Spotify Data API. It takes 3 parameters: q (required), plus numberOfTopResults and contrast (optional). No recorded sample exists for it; press Run to fetch a live response.
Parameters 3
- q Required
- In
- query
- Default
- —
- numberOfTopResults Optional
- In
- query
- Default
- 5
- 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.
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/search_top_results?q=the%20weeknd&numberOfTopResults=5" \ |
| -H "x-api-key: $SPOTIFY_API_KEY" |
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.