Track Playlists
Returns playlists featuring a specific track. Accepts a provider track ID (id) or a track name + optional artist (q, artist) for a Spotify-powered lookup. When no filter flag is passed, defaults to editorial + indie + majorCurator + popularIndie = true. Costs 5 credits per request.
Discover a provider track id via GET /api/research with type=tracks — then pass the resulting id here for the most reliable match (avoids the ambiguity of name-based lookup).
Query Parameters
Provider track ID. Required if q is not provided.
^[A-Za-z0-9][A-Za-z0-9._:-]*$"track_123"
Track name to look up. Required if id is not provided. Combine with artist to narrow the match.
Artist name. Required unless id is provided.
Streaming platform to return playlists for. Defaults to spotify.
spotify, applemusic, deezer, amazon Return current or past playlist placements. Defaults to current.
current, past Maximum number of placements to return.
Pagination offset.
ISO date lower bound for placements.
ISO date upper bound for placements.
Sort column.
Include editorial playlists. When no filter flags are set, defaults to true along with indie, majorCurator, popularIndie.
Include indie playlists.
Include major-curator playlists.
Include popular indie playlists.
Include personalized playlists.
Include chart playlists.
Include New Music Friday playlists.
Include "This Is" artist playlists.
Include algorithmic radio playlists.
Include brand playlists.