Tracks

Get Track Activities

Changed on

Returns the latest activities of a track filtered by source.

For entity-based (Artist/Label) and member API keys, include one artist or label identifier alongside the track identifier: songstats_artist_id, spotify_artist_id, or apple_music_artist_id for an artist; songstats_label_id or beatport_label_id for a label. The track must belong to that artist or label. These entity selectors are optional for request-based API keys.

get/tracks/activities

Request

  • Base URL
    https://api.songstats.com/enterprise/v1
  • URL
    https://api.songstats.com/enterprise/v1/tracks/activities
  • Auth
    API key in header apikey

Query parameters

songstats_track_idstring
Example:k4bp9etx

The Songstats ID of the track being requested *

spotify_track_idstring
Example:1YLGtZjDKyY0Qkv4QlX31b

The Spotify ID of the track being requested *

isrcstring
Example:GBAYE2100626

The ISRC of the track being requested *. When a missing-track lookup schedules background discovery, the 404 response confirms queue acceptance. If the queue rejects that search, the endpoint returns 503 and the request can be retried.

sourcestring required
Example:spotify,apple_music,deezer

Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'.

songstats_artist_idstring
Example:pod5zlug

The Songstats ID of the artist being requested *

spotify_artist_idstring
Example:28j8lBWDdDSHSSt5oPlsX2

The Spotify ID of the artist being requested *

apple_music_artist_idinteger
Example:261545033

The Apple Music ID of the artist being requested *

limitinteger
Example:20

Specifies the limit of results being returned.

offsetinteger
Example:20

Specifies the offset of the limited results being returned.

milestonesboolean
Example:true

Include Milestone Activities.

albumsboolean
Example:true

Include Album Activities.

editorialboolean

Only include Editorial Activities.

tierinteger
Example:4

Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities.

commentsboolean
Example:true

Include Comment Activities.

apple_music_track_idinteger
Example:1567644047

The Apple Music ID of the track being requested *

songstats_label_idstring
Example:7gk4yfc9

The Songstats ID of the label being requested *

beatport_label_idstring
Example:74932

The Beatport ID of the label being requested *

Headers

Accept-Encodingstring
Example:gzip, deflate, br

gzip, deflate, br

Response

OK: The request has succeeded. The client can read the result of the response.

resultstring
messagestring
source_idsstring

Changes

  • fdbeaf377146Revision changes
    • info

      added the new optional query request parameter beatport_label_id

    • info

      added the new optional query request parameter songstats_label_id