Endpoints
/v2/stations
An endpoint for searching for and retrieving information about radio stations, their on-demand content, and their scheduling.
Base URL: https://api.radioplayer.org/v2/stations
METHOD | ENDPOINT | USAGE | RETURNS |
---|---|---|---|
GET | /v2/stations | Return all info about all stations | stations |
GET | /v2/stations/{rpuids} | Return one or more specified stations | station |
GET | /v2/stations/{rpuids}/onair | Return current, "now playing" events and shows, from one or more stations | One or more stations' collections of on-air material |
GET | /v2/stations/{rpuid}/schedule | Return scheduling information for multiple stations | Up to five stations' collection of schedules |
GET | /v2/stations/{rpuid}/ondemand | Return one station's on-demand content | On-demand items for a given station |
GET | /v2/stations/{rpuid}/ondemand/{seriesId} | Returns on-demand content from a single series on a single station | On-demand items from a single series on a single station |
/v2/ondemand
An endpoint for retrieving information about on-demand content using filters and searches.
Base URL: https://api.radioplayer.org/v2/ondemand
METHOD | ENDPOINT | USAGE | RETURNS |
---|---|---|---|
GET | /v2/ondemand | Return on-demand content using filters and searches | On-demand content |
GET | /v2/ondemand/{odlds} | Returns individual items of on-demand content identified by unique IDs | Specified items of on-demand content |
/v2/recommendations
An endpoint for retrieving recommended stations and on-demand content.
Base URL: https://api.radioplayer.org/v2/recommendations
METHOD | ENDPOINT | USAGE | RETURNS |
---|---|---|---|
GET | /v2/recommendations | Return recommended stations | Stations and on-demand content |
/v2/categories
An endpoint for returning stations and content by category.
Base URL: https://api.radioplayer.org/v2/categories
METHOD | ENDPOINT | USAGE | RETURNS |
---|---|---|---|
GET | /v2/categories | Return a list of category types for live or on-demand content | Category data where available |