Changelog

2.49.0- 2026 Mars, 05

New endpoints:
Improvements:
Add credits & mainArtists on resource Song to:
Changes:
Modify the default behavior of startDate: if omitted, it defaults to 30 days before the specified endDate.
Audience metrics for TikTok links are now accessible via the Get song audience endpoint.

2.48.0- 2026 Jan, 19

New endpoints:
Improvements:
Add ISWCs on resource Song to:
Deprecated:
  • Tiktok - Get music videos
  • Tiktok - Get user
  • Tiktok - Get video
  • Tiktok - Add music links
  • Tiktok - Add user links

2.46.1- 2025 Nov, 14

Improvements:
Metadata audio resources and filters added on Get songs
  • duration
  • tempo
  • timeSignature
  • acousticness
  • danceability
  • energy
  • instrumentalness
  • songKey
  • liveness
  • loudness
  • songMode
  • speechiness
  • valence
Add description, trackAge, trackAddedPercent, genres on resource Playlist to:
Add webUrl on resource Artist to:
Endpoints with startDate, endDate, period params are not limited anymore

2.46.0- 2025 October, 22

New endpoints:
Improvements:
  • songScore added on custom metric on Get songs

2.45.3- 2025 September, 24

Improvements:
Twitter renamed to X. Added X to platform reference (see Get platforms).

2.45.2- 2025 September, 11

Improvements:
Add growthLevel on resource Artist to:

2.45.1- 2025 August, 01

Improvements:
Add playlistUuids filter and exitDate resource to:
Add entryDate and exitDate resources to:

2.45.0- 2025 July, 01

New endpoints:
Improvements:

2.44.0- 2025 June, 09

Improvements:
Search Add countryCode, genres, isni and careerStage to:
Search Add the ability to put slashes in the search term:

2.43.0- 2025 May, 22

New endpoints:
Album

2.41.0- 2025 Apr, 04

New endpoints:
Improvements:
releaseDate sort added to:

2.39.1- 2025 March, 06

Improvements:
Support tiktok platform on: Get shorts videos
careerStage added to: Get artist metadata

2.39.0- 2025 Feb, 06

New endpoint:

2.38.0- 2025 Jan, 21

New endpoint:
  • Get artist ranking (deprecated)
  • Get artist ranking for a country (deprecated)
  • Get artist ranking for a city (deprecated)

2.37.1.0- 2024 Nov, 15

Improvements:
Add url venue in Get Songkick events resource to :

2.37.0- 2024 Oct, 24

New endpoints:
  • Get Spotify monthly listeners - latest (deprecated)
  • Get Spotify monthly listeners by month
  • Get youtube views latest (deprecated)
  • Get youtube views by month (deprecated)
  • Get local audience (deprecated)

2.36.0- 2024 Oct, 03

Improvements:
Add type and replace label by labels (new structure) on album resource to :
Added explicit on song resource to :

2.35.0- 2024 Sept, 05

Endpoint deprecated:
New endpoints:
Improvements:

2.34.0- 2024 June, 24

Improvements:
Add type on Album resource to :
Endpoint deprecated:

2.33.0- 2024 May, 14

Improvements:
Added HighPrice,LowPrice and Currency on Event resource to :
Added Birthdate and Type on Artist resource to :
Improve Artist - Get songs performances

2.32.0- 2024 Apr, 15

New endpoints:
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(deprecated)
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 endpoints:
Added the Get Spotify popularity (deprecated) 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 endpoints:
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 (deprecated)

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 (deprecated)

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

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
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 (deprecated) 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 (deprecated)
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 (Artist)
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 (deprecated)
Added the Tiktok : Get user audience (deprecated)
Added the Tiktok : Get video (deprecated)

2.5.0 - 2021 Mar. 07

New endpoints:
Added the Tiktok : Add music links (deprecated)
Added the TikTok : Add user links (deprecated)

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(deprecated)
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 endpoints:
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)