API Reference

Get playlist activity

get
https://api.artist.tools/v2/playlists//activity

Returns a paginated timeline of track additions and removals for a playlist. Useful for building an activity feed, tracking when specific tracks were added or removed, or identifying botted playlist behavior over time.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Spotify Playlist ID

Query Params
integer
1 to 100
Defaults to 1

Page number (1-indexed, max 100). If you need deeper results, narrow your date range with startDate/endDate.

integer
1 to 25
Defaults to 25

Number of items per page (max 25)

date-time

Only return events that happened at or after this date (ISO 8601). Must be before endDate if both are provided.

date-time

Only return events that happened at or before this date (ISO 8601). Must be after startDate if both are provided.

string
enum

Filter by event type. If omitted, both additions and removals are returned.

Allowed:
boolean

Filter by whether the playlist involved was detected as botted. true = only botted, false = only non-botted, omit = all.

string

Comma-separated list of Spotify Artist IDs to filter by (max 10)

string

Comma-separated list of Spotify Track IDs to filter by (max 10)

string

Comma-separated list of playlist owner Spotify User IDs to filter by (max 10)

Responses

Updated 29 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 29 days ago