Get song platform audience

Get audience metrics for a song on a specific music or social platform.

Name

get_song_platform_audience

Schema

Type
object

Properties

Name Description Example
songId Unique identifier of the song 7d534228-5165-11e9-9375-549f35161576
platform Platform used to retrieve audience metrics for the song. spotify
startDate Optional Start date (inclusive) in ISO format YYYY-MM-DD. Defaults to 30 days before today if omitted. 2026-01-01
endDate Optional end date (inclusive) in ISO format YYYY-MM-DD. Defaults to the current date when omitted. 2026-02-01
limit Maximum number of results to return.
offset Number of results to skip before starting to return results. Used for offset-based pagination.

Required

Name
songId
platform