Available API Endpoints

Those are the API Endpoints available under the provided token.

Built by GA Galeo_AIE

ranking_by

Returns the ranking of songs/artists/albums/sources/countries sorted by plays. For each row, returns plays, income and song_id (the ID of any song for that group) It also lets you filter by artist, country, source, song or album. Examples of global rankings: * top songs global: ?by=song_title, also no params at all * top albums global: ?by=album_name * top countries global: ?by=country * top sources global: ?by=source Examples, filtering the results by artist/country/source: * top songs, filter by artist: ?by=song_title&artist=green day, also just ?artist=green day * top albums, filter by artist: ?by=album_name&artist=green day * top countries, filter by artist: ?by=country&artist=green day * top sources, filter by artist: ?by=source&artist=green day * top songs, filter by country: ?country=spain * tops songs, filter by country and source: ?country=spain&source=spotify * tops songs, filter by country, source and artist: ?country=spain&source=spotify&artist=green day * tops albums, filter by country, source and artist: ?by=album_name&country=spain&source=spotify&artist=green day

evolution_plays_income_per_second

Second evolution for the last 2 minutes of song plays and income over time and filter the results by song, artist, country, source, album, or not filter at all.

Examples: * global evolution: call the endpoints without parameters * evolution filter by artist: ?artist=bad bunny * evolution filter by song: ?song=imagine * evolution filter by country and artist: ?country=spain&artist=bad bunny * evolution filter by country, source and artist: ?country=spain&artist=bad bunny&source=spotify

evolution_plays_income_from_mv

Daily evolution of song plays and income over time and filter the results by song, artist, country, source, album, or not filter at all.

All the calls can have a filter to set the amount of days you want to receive, like days=7

Example * global evolution: call the endpoints without parameters * evolution filter by artist: ?artist=bad bunny * evolution filter by song: ?song=imagine * evolution filter by country and artist: ?country=spain&artist=bad bunny * evolution filter by country, source and artist: ?country=spain&artist=bad bunny&source=spotify

search_artist

Lets you search artists by name.

Returns all the artists whose name matches the passed artist param and song_id, the ID of any of the songs from that artist