Changelog

2.32.0- 2024 Apr, 15

New endpoint:
Added the Get radio ranking

2.31.0- 2024 Feb, 05

New endpoints:
Added the Get song ranking
Improvements:
Added peakDate on SongRank, AlbumRank resource to :

2.30.1- 2023 Dec, 11

Improvements:
Added duration on SongBroadcast resource to :
Mark Song - Get Youtube views by id as deprecated.
In favor of Song - Get Audience where we added an "identifier" query parameter
Added default on SongIdentifier

2.30.0- 2023 Nov, 30

New endpoints:
Added the Artist - Get retention
Improvements:
Add gender data on Artist resource

2.29.1- 2023 Nov, 16

Improvements:
Add Affinity Weight resource with data :
  • Name
  • Weight
  • Affinity
Add Lookalike resource with data :
  • User name
  • Full Name
  • Follower count
  • Engagement Count
  • Url
  • Image Url
  • Country Code
  • Score
Add Reel resource with data :
  • Date
  • Url
  • Text
  • Like Count
  • Comment Count
  • Play Count
  • Mentions
Add Reels data on Top resource
Add Relevant Tags resource with data :
  • Name
  • Distance
  • Freq
Add Relevant Tags data on Audience resource
Add Average Reels Plays data on Audience Stats resource
Add new data on Audience Detail :
  • Types
  • Credibility
  • Credibility Class
  • Reachabilities
  • Notable User Ration
  • Lookalike
  • Interests
  • Brand Affinities
on :

2.29.0- 2023 Nov, 16

New endpoints:
Added the Song - Get albums
Improvements:
Add Audio data on song resource to :

2.28.2- 2023 Oct, 16

Improvements:
Add peakPosition on rank resource to :
Add producers on song resource to :

2.28.1- 2023 Oct, 02

Improvements:
Replace slug by uuid on album resource to :

2.28.0- 2023 Sept, 25

New endpoints:
Added the Search playlist by name
Improvements:
Added ipi & isni identifiers on artist resource to :
Transform x-request-id header format to an UUID format

2.27.6 - 2023 Sept, 18

New endpoints:
Added the Get artist ranking for a city
Added the Get artist cities ranking

2.27.5 - 2023 July, 12

New endpoints:
Added the Get artist ranking for a country
Added the Search song by name

2.27.4 - 2023 May, 05

Improvements:
Added countryCode parameter on the Get artist ranking endpoint

2.27.3 - 2023 May, 03

New endpoint:
Added the Get Spotify popularity endpoint with popularity for each song identifier
Improvements:
Added frequency on chart resource to :
Added current on chart resource to :

2.27.2 - 2023 April, 19

New endpoint:
Added the Get Soundcharts URL from platform URL endpoint

2.27.1 - 2023 March, 17

Improvements:
Added biography on Get artist metadata endpoint

2.27.0 - 2023 March, 09

New endpoints:
Added the Get artist ranking

2.25.0 - 2023 Jan. 03

Improvements:
Replace label by labels (new structure) on song resource to Get song metadata, Get song by ISRC, Get song by platform ID endpoints
Bugfix:
Fix default period and pagination for song audience endpoints :

2.24.0 - 2022 Oct. 12

Improvements:
Song audience is now associated to its identifiers for Get Spotify streams & Get Shazam count

2.23.0 - 2022 Aug 29

New endpoints:
Added the Get blocklists artists
Added the Get blocklists songs
Added the Get blocklists labels

2.22.0 - 2022 June 06

Improvements
Added firstAiredAt on radio resource to Get radios & Get radios by country endpoints

2.21.0 - 2022 May 05

Improvements
Added releaseDate on song resource to Artist - Get songs

2.19.0 - 2022 Feb. 21

Improvements
Added externalId and status on event resource to Get Songkick events

2.18.0 - 2022 Jan. 20

Improvements
Added releaseDate on album resource to Artist - Get albums
Added reach on radio resource to Get radios & Get radios by country endpoints

2.17.0 - 2022 Jan. 17

New endpoints:
Added the Artist - Get songs

2.16.0 - 2022 Jan. 05

New endpoints:
Added the Get artist list
Added the Add artists IDs
Added the Delete artists IDs
Added the Get song list
Added the Add songs IDs
Added the Delete songs IDs
Improvements:
Added name and creditName resource to Get YouTube IDs endpoint

2.15.0 - 2021 Dec. 16

Improvements:
Added imageUrl on album resource to Get album by UPC & Get album metadata (deprecated) & Get album by platform ID endpoints

2.14.0 - 2021 Nov. 10

Improvements:
Added metric on chart & rank resources to Get song ranking - latest & Get song ranking for a date endpoints

2.13.0 - 2021 Nov. 02

New endpoints:
Added the Artist - Get IDs
Added the Song - Get IDs
Added the Album - Get IDs

2.12.0 - 2021 Sept. 27

New endpoints:
Added the Get audience
Added the Get Shazam count
Added the Get YouTube views
Added the Get YouTube views by ID
Added the Get YouTube IDs
Improvements:
Added type filter & subscriberCount sort to Artist - Get playlist entries & Song - Get playlist entries endpoints

2.11.0 - 2021 Sept. 02

New endpoints:
Added the Get Spotify streams
Added the Get Spotify popularity (deprecated)
Improvements:
Added following_count & like_count on TikTok user audience resource to Get user audience endpoint
Added a dedicated error code 410 for Get song by ISRC & Get song by platform ID endpoints when ISRC is blacklisted. ISRC may be blacklisted because DSP identified them as different tracks.

2.10.0 - 2021 Aug. 31

New endpoints:
Added the Get user videos

2.9.0 - 2021 June 30

New endpoints:
Added the Artist - Get albums
Added the Get Songkick events
Improvements:
Added genres on artist resource to Get artist metadata and Get artist by platform ID endpoints

2.8.0 - 2021 June 15

New endpoints:
Added the Get Spotify popularity
Added the Get curators by platform
Improvements:
Added appUrl and imageUrl on playlist resource to Get playlist metadata endpoint
Added isrc country code and country name, genres, composers on song resource to Get song metadata, Get song by ISRC, Get song by platform ID endpoints

2.7.0 - 2021 May 11

New endpoints:
Added the Artist : Get chart album entries
Added the Album : Get tracklisting
Added the Album - Get chart entries
Added the Get playlists by type
Improvements:
Added sortName and sortOrder optional parameters to Get playlists by curator endpoint
Bugfix:
Resolve spotify identifiers matching on Get artist by platform ID endpoint

2.6.0 - 2021 May 04

New endpoints:
Added the Tiktok : Get music
Added the Tiktok : Get user
Added the Tiktok : Get user audience
Added the Tiktok : Get video

2.5.0 - 2021 Mar. 07

New endpoints:
Added the Tiktok : Add music links
Added the TikTok : Add user links

2.4.0 - 2021 Feb. 12

Improvements:
Added sortName and sortOrder optional parameters to the following endpoints, more information in the dedicated documentation page:
Global Performance improvements
Bugfix:
Empty countryPlots and cityPlots for Get local audience
Empty data when startDate equals endDate for Get radio spins

2.3.0 - 2021 Jan. 21

New endpoints:
Added the Get radio spins (artist) endpoint, quite slow but performance increase is scheduled soon
Improvements:
The date management has been unified for the following endpoints and documentation has been updated accordingly:

2.2.0 - 2021 Jan. 08

New endpoints:
Added the Get music videos endpoint
Added the Get video audience endpoint

2.1.0 - 2021 Jan. 04

New endpoint:
Added the Get playlists by curator endpoint
Bugfix:
The date format for Get song ranking dates is now using ATOM
Fixed some artists not properly hydrated in the get song endpoint
Minor documentation improvements, the sandbox dataset page was added.

2.0.0 - 2020 Nov. 23

This is the first release of Soundcharts API 2.x branch

Major changes:
Endpoint urls have been cleaned and simplified for easier ramp up, they are now grouped by concern (Artist / Song / Radios..)
Request parameters and responses are now unified (see the Getting started page)
Endpoints not using a unique identifier (UUID or slug) have been deprecated
A brand new documentation making the former Sandbox page useless (all endpoints can be tested here using the "Try" button)