Search playlists

get

https://api.artist.tools/v2/playlists/search

Performs a keyword, genre, playlist ID, or owner-based search and returns paginated playlists. Playlist IDs and owner IDs are combined with AND by default; pass idsOwnerOperator=or to match either explicit playlist IDs or owner filters. excludeIds and excludeOwnerIds always exclude matching playlists after positive filters are applied. Playlist objects include track summary fields and, when available, tracks.items with per-track metadata.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

Primary search string

page

integer

≥ 1

Defaults to 1

Page number for paginated searches

limit

integer

≤ 500

Defaults to 25

Number of items per page (max 500)

sort

string

Mongo-style JSON object describing sort order (URL-encoded)

queryExactly

string

Exact phrase search in playlist names and descriptions

queryExclude

string

Words to exclude from search results

genres

array of strings

Comma-separated list of genres that playlists must contain

genres

artistNames

array of strings

Comma-separated list of artist names that playlists must contain

artistNames

artistIds

array of strings

Comma-separated list of Spotify artist IDs

artistIds

trackIds

array of strings

Comma-separated list of Spotify track IDs

trackIds

ids

array of strings

Comma-separated list of Spotify playlist IDs to filter results

ids

excludeIds

array of strings

Comma-separated list of Spotify playlist IDs to exclude from results

excludeIds

minFollowers

integer

≥ 0

Minimum number of followers

maxFollowers

integer

≥ 0

Maximum number of followers

minListeners

integer

≥ 0

Minimum number of monthly listeners

maxListeners

integer

≥ 0

Maximum number of monthly listeners

hasContact

boolean

Filter playlists that have contact information available

contacts

array of strings

Specific contact types to filter by

contacts

hideCrap

boolean

Hide low quality playlists (quality score >= -10)

hideInactive

boolean

Hide playlists inactive for more than 30 days

newestTrackDate

integer

≥ 1

Filter playlists updated within the last N days

excludeEditorials

boolean

Exclude Spotify editorial playlists

editorialOnly

boolean

Show only Spotify editorial playlists

bottedOnly

boolean

Show only playlists detected as botted

activeOnly

boolean

Show only playlists with high daily follower growth

avgDailyFollowers

integer

≥ 0

Minimum average daily follower growth

ownerId

string

Filter by specific playlist owner ID

ownerIds

array of strings

Comma-separated list of playlist owner IDs

ownerIds

excludeOwnerIds

array of strings

Comma-separated list of playlist owner IDs to exclude from results

excludeOwnerIds

idsOwnerOperator

string

enum

Defaults to and

Controls how ids combines with ownerId and ownerIds. Use and to require both playlist ID and owner filters, or or to match either. Exclusion filters still apply.

Allowed:

collaboratorIds

array of strings

length ≤ 10

Comma-separated list of curator Spotify User IDs to filter playlists where the curator is a collaborator (max 10)

collaboratorIds

hideRemoved

boolean

Hide playlists marked as removed

includeCurators

boolean

Include curator search results alongside playlists

minAge

integer

≥ 0

Minimum number of days since the playlist was first ingested into our dataset

Responses

200Paginated playlist search results with optional curator data

404Resource not found