Artists

Get Artist Historic Stats

Returns historic information of an artist filtered by source. Facebook history includes public follower and talking-about counts only; authorized account insights such as reach, impressions and earnings are not included.

get/artists/historic_stats

Request

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

Query parameters

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 *

start_datestring date
Example:2021-12-31

Specifies the start_date of the historic data that is being requested.

end_datestring date
Example:2022-01-16

Specifies the end_date of the historic data that is being requested.

with_aggregatesboolean
Example:true

Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc.

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

No recorded changes to this operation across all 3 revisions of this API.