Changelog

2.37.1.0- 2024 Nov, 15

Improvements:

Add url venue in Get Songkick events resource to :

• Get Songkick events

Deprecated:

• Get Shazam count (deprecated)
• Get Spotify streams (deprecated)

2.37.0- 2024 Oct, 24

New endpoints:

• Get lyrics analysis
• Get local streaming audience
• Get artist genres
• Get local audience

Deprecated:

• 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 :

• Get album metadata
• Get album by UPC
• Get album by platform ID

Added explicit on song resource to :

• Get song metadata
• Get song by ISRC
• Get song by platform ID

2.35.0- 2024 Sept, 05

Endpoints deprecated :

• Tiktok - Get user videos
• Tiktok - Get video audience
• Artist - Get spotify popularity

New endpoints:

• Artist - Get short videos
• Artist - Get short video audience
• Artist - Get popularity
• Artist - Get current stats
• Artist - Get radio spin count
• Radio - Get ids
• Search radio by name

Improvements:

• Add filter platform on the Get IDs endpoint for artists, Get IDs for songs or Get IDs for albums or Get IDs for radios endpoints.

2.34.0- 2024 June, 24

Improvements:

Add type on Album resource to :

• Artist - Get albums
• Song - Get albums

Endpoints deprecated :

• Tiktok - Get user audience
• Get artists by country

2.33.0- 2024 May, 14

Improvements:

Added HighPrice,LowPrice and Currency on Event resource to :

• Artist - Get songkick events

Added Birthdate and Type on Artist resource to :

• Get artist metadata
• Get artist by platform ID

Improve Artist - Get songs performances

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 :

• Song - Get chart entries
• Album - Get chart entries

2.30.1- 2023 Dec, 11

Improvements:

Added duration on SongBroadcast resource to :

• Get live feed

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 :

• Get audience report - latest
• Get audience report for a date

2.29.0- 2023 Nov, 16

New endpoints:

Added the Song - Get albums

Improvements:

Add Audio data on song resource to :

• Get song metadata
• Get song by ISRC
• Get song by platform ID

2.28.2- 2023 Oct, 16

Improvements:

Add peakPosition on rank resource to :

• Get chart song entries (artist)
• Get chart album entries (artist)
• Get chart entries (song)
• Get chart entries (album)

Add producers on song resource to :

• Get song metadata
• Get song by ISRC
• Get song by platform ID

2.28.1- 2023 Oct, 02

Improvements:

Replace slug by uuid on album resource to :

• Get chart album entries (artist)

2.28.0- 2023 Sept, 25

New endpoints:

Added the Search playlist by name

Improvements:

Added ipi & isni identifiers on artist resource to :

• Get artist metadata
• Get artist by platform ID

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 :

• Get song chart list by platform
• Get song ranking - latest
• Get song ranking dates
• Get song ranking for a date
• Get album chart list by platform
• Get album ranking latest
• Get album ranking dates
• Get album ranking for a date
• Get chart song entries (artist)
• Get chart album entries (artist)
• Get chart entries (song)
• Get chart entries (album)

Added current on chart resource to :

• Get chart song entries (artist)
• Get chart album entries (artist)
• Get chart entries (song)
• Get chart entries (album)

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.26.0 - 2023 Feb. 03

New endpoints:

Added the Get album metadata

Added the Get listeners/streams/views

Added the Get live feed

Added the Get audience endpoint for a song

Added the Add links endpoint for a song

Improvements:

Replace slug by uuid on album resource to :

• Get album metadata
• Artist - Get albums
• Album : Get IDs
• Album : Get tracklisting
• Get album ranking for a date
• Get album ranking - latest

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 :

• Get Shazam count
• Get Spotify streams
• Get Spotify popularity (deprecated)
• Get YouTube views
• Get YouTube views by ID

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.20.0 - 2022 Mar. 30

Improvements :

Added type on playlist resource to endpoints:

• Get playlist entries (artist)
• Get playlist entries (song)
• Get playlists by curator
• Get playlists by type
• Get tracklisting - latest
• Get tracklisting dates
• Get tracklisting for a date
• Playlist : Get audience

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

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.6.0 - 2021 May 04

New endpoints:

Added the Tiktok : Get music

Added the Tiktok : Get user

Added the Tiktok : Get user audience (deprecated)

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:

• Get chart song entries (artist)
• Get playlist entries (artist)
• Get chart entries (song)
• Get playlist entries (song)

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:

• Get followers (artist)
• Get radio spins (song)
• Get radio spin count (song)

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)