List historical events

Returns known events that help explain changes or gaps in historical metrics. These can include platform updates, widespread anomalies, data collection outages, and changes to how artist.tools calculates or displays metrics.

Spotify examples include the September 1 Search update affecting spammy playlists and widespread follower purges.

Filter events by platform, entity, metric or date range. Each event explains what happened, when it happened, and which data it affects. Only public events are included, and coverage is not exhaustive. Currently supports Spotify.

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

Currently spotify only.

Allowed:
string
enum

Filter to one Spotify entity type.

Allowed:
string

Normalized Spotify entity ID; requires entityType.

string

Comma-separated canonical measurement paths; requires entityType. E.g. followers.total, monthlyListeners or streams.total, with paths valid for that entity.

date-time

UTC instant, inclusive lower history bound.

date-time

UTC instant, exclusive upper history bound.

Responses

400

Unknown/unsafe filter, invalid ID/metric/type, non-UTC or reversed time window.

401

Authentication required.

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