API Reference

Get artist activity

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

Returns a paginated timeline of playlist additions and removals for an artist's tracks. Useful for building an activity feed showing which playlists have picked up or dropped the artist over time, tracking the exact timing of botted playlist adds/removes, or mapping out how playlist placements lead into others.

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

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

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