API Reference

Get curator activity

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

Returns a paginated timeline of track additions and removals across all playlists owned by a curator. Useful for monitoring a curator's playlist management patterns, identifying when botted curators add or remove tracks, or building an activity feed of a curator's behavior over time.

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

Spotify User ID of a curator

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)

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