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 |
11e82612-052b-f4f4-a20c-a0369fe50396 |
| 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