API Reference

Get track activity

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

Returns a paginated timeline of playlist additions and removals for a track. Useful for building a playlist journey timeline (similar to Chartmetric's Playlist Journeys), tracking which playlists picked up or dropped a track and when, or identifying botted playlist placements.

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

Spotify Track 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 Playlist IDs to filter by (max 10)

string

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

Responses

Updated 16 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 16 days ago