Endpoints
This is an unsupported tool for basic requests and your experiences may vary. If you wish to experiment with complex requests, you should script against the API directly.
/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 |
|---|---|---|---|
| POST | /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 |