Summary
Playable items in the guide often require a “tune” to resolve specific listening options. This is especially true of shows, which may be broadcast on multiple stations and may also have recent episodes available as podcasts or downloads.
Tune Station
All content links that contain stations ultimately point to a station tune URL. This method creates a playlist from streams associated with the station.
Input
GET http://opml.radiotime.com/Tune.ashx?id=s32500
| Parameter | Description |
|---|---|
| id | The guide ID for the station to tune |
| c | If set to ebrowse, will return individual tune links for streams. Otherwise will tune normally |
Output
Unless the c parameter is set, this method will return a media playlist, usually of type M3U. In other words, it will not be an OPML document.
If the c parameter is set for a stream browse, you will receive individual OPML links for streams.
Tune Show
Shows may air on multiple stations or have multiple episodes available for download on demand. The tuning call provides links to all available options.
Input
# Tune Fresh Air
GET http://opml.radiotime.com/Tune.ashx?c=pbrowse&id=p17
| Parameter | Description |
|---|---|
| c | If set to pbrowse, lists recent episodes of a show along with a listen now link. If there are no recent episodes, a list of available stations will result. If set to sbrowse , lists available stations for a show, grouped by time remaining |
| id | The guide ID of the show |
| flatten | If set to true, the service will return a flat list of stations rather than time groups. |
Output
A set of outline groups containing individual stations currently airing the program, as well as a group containing recent topics, if available.