Get top songs for an artist
Retrieves the top songs for a given artist based on metrics.
path Parameters
idGet top songs for an artist › Responses
Top songs retrieved successfully
idUnique identifier of the song
titleSong title
durationSecondsDuration in seconds
explicitIndicates explicit content
videoUrlURL of the video associated with the song
storageReferenceOpaque storage reference or URI to the audio asset
collectionIdIdentifier of the parent collection/album
coverUrlCollection cover for song image display
releaseDatePublic release datetime in ISO-8601 UTC
primaryArtistNamePrimary artist display name
primaryArtistIdIdentifier of the primary artist
collaboratorIdsIdentifiers of collaborator artists
genresGenre classifications for the song
moodsMood classifications that the song evokes
blockedAdminIndicates if the song is blocked by an administrator
effectiveStateEffective availability state
likesCountNumber of likes
createdAtCreation timestamp in ISO-8601 UTC
updatedAtLast update timestamp in ISO-8601 UTC
likedWhether the current user has liked this song
relevanceScoreRelevance score for search results (null if not from search)
levenshteinDistanceLevenshtein distance for search results (null if not from search)
Get top collections by artist
Retrieves the top collections for a specific artist based on popularity.
path Parameters
idGet top collections by artist › Responses
Top collections retrieved successfully
idUnique identifier of the collection
titleTitle of the collection
descriptionDescription of the collection
coverUrlURL of the collection's cover image
typeType of the collection
effectiveStateStatus of the collection
primaryArtistIdID of the primary artist
primaryArtistNameName of the primary artist
scheduledReleaseDateScheduled release date of the collection
actualReleaseDateActual release date of the collection
createdAtDate and time when the collection was created
updatedAtDate and time when the collection was last updated
relevanceScoreRelevance score for search results (null if not from search)
levenshteinDistanceLevenshtein distance for search results (null if not from search)
isSavedIndicates whether the current user has saved/bookmarked this collection
Get top performing songs for an artist
Returns top 5 performing songs by plays and likes for an artist. Requires start_date and end_date parameters.
path Parameters
artistIdArtist UUID
query Parameters
startDateStart date (YYYY-MM-DD)
endDateEnd date (YYYY-MM-DD)
regionRegion to filter (optional)
User Region
Get top performing songs for an artist › Responses
Top songs found
Top songs ranked by plays
Date range with start and end dates
Get top performing playlists for an artist
Returns top 5 performing playlists by plays and saves that contain songs by the artist. Requires start_date and end_date parameters.
path Parameters
artistIdArtist UUID
query Parameters
startDateStart date (YYYY-MM-DD)
endDateEnd date (YYYY-MM-DD)
regionRegion to filter (optional)
User Region
Get top performing playlists for an artist › Responses
Top playlists found
Top playlists ranked by plays
Date range with start and end dates
Get top performing collections for an artist
Returns top 5 performing collections by plays and saves for an artist. Requires start_date and end_date parameters.
path Parameters
artistIdArtist UUID
query Parameters
startDateStart date (YYYY-MM-DD)
endDateEnd date (YYYY-MM-DD)
regionRegion to filter (optional)
User Region
Get top performing collections for an artist › Responses
Top collections found
Top collections ranked by plays
Date range with start and end dates
Get artist overview metrics
Returns comprehensive metrics for an artist including KPIs with temporal variations. Requires start_date and end_date parameters.
path Parameters
artistIdArtist UUID
query Parameters
startDateStart date (YYYY-MM-DD)
endDateEnd date (YYYY-MM-DD)
regionRegion to filter (optional)
User Region
Get artist overview metrics › Responses
Artist overview metrics found
artistIdArtist unique identifier
artistNameArtist display name
avatarUrlArtist avatar/profile image URL
primaryGenreMain genre classification
Key Performance Indicators for an artist
Information about the analyzed time period
Filters currently applied to the data
lastUpdatedTimestamp when metrics were last updated
Get market distribution for an artist
Returns market distribution for an artist by plays with period comparison. Requires start_date and end_date parameters.
path Parameters
artistIdArtist UUID
query Parameters
startDateStart date (YYYY-MM-DD)
endDateEnd date (YYYY-MM-DD)
topNNumber of top markets to return (1-50)
Get market distribution for an artist › Responses
Market distribution found
artistIdArtist ID
Information about the analyzed time period
totalMarketsTotal number of markets
Distribution by region
Other markets total information
lastUpdatedTimestamp when metrics were last updated
Get artist history (time-series data)
Returns time-series data for total plays per day for artist's songs, collections, and playlists. Requires start_date and end_date parameters.
path Parameters
artistIdArtist UUID
query Parameters
startDateStart date (YYYY-MM-DD)
endDateEnd date (YYYY-MM-DD)
regionRegion to filter (optional)
User Region
Get artist history (time-series data) › Responses
Artist history found
Daily total plays for songs
Daily total plays for collections
Daily total plays for playlists
Date range with start and end dates