Get recent radio airplay events for a song, optionally filtered by radio station or country
Name
get_song_radio_plays
Schema
Properties
| Name |
Description |
Example |
|
songId
|
Unique identifier of the song
|
7d534228-5165-11e9-9375-549f35161576
|
|
radioId
|
Specific radio station name to filter
|
bbc-1
|
|
country
|
Filter by country code
|
US
|
|
startDate
|
Start date (inclusive) in ISO format YYYY-MM-DD. Defaults to 30 days before today if omitted.
|
2026-01-01
|
|
endDate
|
End date (inclusive) in ISO format YYYY-MM-DD. Defaults to the current date when omitted.
|
2026-02-01
|
|
limit
|
Maximum number of items to return.
|
|
|
offset
|
Number of items to skip before starting to return results. Used for offset-based pagination.
|
|
Required