Endpoint Playground
Returns Spotify playlist search results for a search term. Caller-supplied Spotify bearer or client tokens are not required.
14 Oct 2026: 52 results; 4 fields had a value in every checked item and 3 varied between items.
Sample value profiles: type: Playlist (30), User (22); uri: “spotify:playlist:2yAdfFOQ2lbhA03Jc9oFvx” and 51 other values; imageUrl: image-cdn-ak.spotifycdn.com and 6 other hosts.
curl "https://api.crawlora.net/api/v1/spotify/playlists/search?q=hello" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | hello | Search term |
| offset | integer | No | Search offset | |
| limit | integer | No | Playlist result limit, clamped to 1-50 | |
| number_of_top_results | integer | No | Top result limit, clamped to 1-50 | |
| include_audiobooks | boolean | No | Include audiobook context where available | |
| include_pre_releases | boolean | No | Include pre-release results | |
| include_album_pre_releases | boolean | No | Include album pre-release results | |
| include_authors | boolean | No | Include authors | |
| include_episode_content_ratings_v2 | boolean | No | Include Spotify episode content ratings v2 |
{
"code": 200,
"msg": "OK",
"data": {
"searchTerm": "hello",
"playlists": [
{
"uri": "spotify:playlist:example",
"type": "Playlist",
"title": "Hello",
"externalUrl": "https://open.spotify.com/playlist/example"
}
],
"meta": {
"operationName": "searchPlaylists",
"playlistCount": 1,
"fetchedAt": "2026-05-13T15:22:41Z"
}
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.