search_stations
Search radio stations
Search live radio stations in the OndaCast catalogue by name, with optional country, genre and language filters. Returns up to `limit` stations with an OndaCast page link for listening. It is for finding a station to listen to or play: each result links to the station's OndaCast page. Only stations that play in a web browser over a secure connection are listed. Country, genre and language use the English names shown in OndaCast's filters.
Parametersgenrelimitqueryrequiredcountrylanguage
get_station
Get a radio station
Get one radio station from OndaCast by slug or OndaCast page address: description, location, genres, language, frequency, the song playing now and the show on air when known, and the OndaCast page for listening. Stations that cannot play in a browser are not available. It is for listening to or playing a station: the answer links to the station's OndaCast page.
Parametersstationrequired
search_podcasts
Search podcasts
Search podcasts in the OndaCast catalogue by title or topic, with an optional language filter. Returns up to `limit` shows with an OndaCast page link. When OndaCast has no match, it may list shows from a public podcast directory that are not on OndaCast yet; the add_podcast tool can add one.
Parameterslimitqueryrequiredlanguage
add_podcast
Add a podcast to OndaCast
Add a podcast from a public podcast directory to OndaCast, by the directoryId that search_podcasts returned in notOnOndaCastYet. This creates the show's OndaCast page and is the only tool that changes anything. It takes no web address: only directory ids such as itunes-123 or pi-456. Additions are limited per client and per day.
ParametersdirectoryIdrequired
Get one podcast from OndaCast by slug or OndaCast page address: author, description, language, category, its latest episodes with OndaCast page links, and the show's OndaCast page.
Parameterspodcastrequired
search_audiobooks
Search audiobooks
Search the public-domain audiobooks in the OndaCast catalogue by title or topic, with an optional language filter. Returns up to `limit` audiobooks with an OndaCast page link.
Parameterslimitqueryrequiredlanguage
get_charts
Get the live charts
Get OndaCast's live song or artist chart, counted from what stations played, for the last 24 hours or 7 days, worldwide or for one country. Returns ranked entries with plays and OndaCast page links.
Parameterskindlimitwindowcountry
radio_guide_now
Radio guide: on air now
List radio shows on air right now in OndaCast's radio guide, with their hosts, when they end in the show's own time zone, and the stations that carry them, each with an OndaCast page link. Optional country and genre filters.
Parametersgenrelimitcountry
catalog_facts
OndaCast facts and figures
Get verifiable facts about OndaCast: what it offers and how large the catalogue is, as figures rounded down and refreshed weekly, with links to its main pages.
Takes no parameters.