Retrieve schedules for one or more stations
/stations/{rpuids}/schedule
Returns scheduling information for up to five station
objects. Results are returned by station.
Endpoint
Base URL: https://api.radioplayer.org/v2/stations/{rpuids}/schedule
Request Parameters
Header Fields
To find out how to correctly construct authentication headers for the Radioplayer Partner API (WRAPI) please see the Authentication guide.
Path Parameters
Get station schedule for stations
/v2/stations/3722,372101/schedule
PATH PARAMETER | VALUE |
---|---|
{rpuids} |
Specifies one or more station objects by their rpuid , which can be requested using a comma separated list |
Query Parameters
Get station schedule with from/to date, page and size
/v2/stations/8261004,826100/schedule?from=2020-06-09T15%3A27%3A33%2B0000&to=2020-06-11T15%3A27%3A33%2B0000&page=1&size=7
QUERY PARAMETER | VALUE |
---|---|
from |
The start time of the schedule in ISO8601 format. Optional. If the from and to parameters are omitted, then the API returns the station’s schedule for the next 24 hours starting from the nearest hour before the current time. Note: if using the from parameter, it is necessary to also apply the to parameter. |
to |
Optional. The end time of the schedule in ISO8601 format. If from and to parameters are omitted, then the API returns the station’s schedule for the next 24 hours starting from the nearest hour before the current time. Note: if using the to parameter, it is necessary to also apply the from parameter. |
page |
Optional. If the results are paginated, this specifies which page is returned. |
size |
Optional. This specifies the maximum number of results to return in the response. |
Response
When successful, the HTTP status code in the response header is 200 OK.
An array of nested ids identifying schedules are returned for each specified rpuid.
These are returned in JSON format (or on special request, XML supported by the RadioDNS schema).
content-type: application/json; charset=utf-8
x-ratelimit-limit: 300000
x-ratelimit-remaining: 285030
x-ratelimit-reset: 1585699200
If there is an error, the header returns an error status code.
The WRAPI also includes information about your monthly request quota in the returned header:
This includes information on:
- Your total monthly quota
- How many requests you have remaining for the month
- When the quota will be reset, given as a UNIX timestamp.
Example Response Body
{
"data": [
{
"data": [
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-27T13:00:00",
"locations": [
{
"scheduledStart": "2020-03-27T13:00:00Z",
"scheduledStop": "2020-03-27T16:00:00Z"
}
],
"description": "Danielle Perry brings you the No Repeat Guarantee - loads of great music and you'll never hear the same song twice. Text now on 81215 (50p + n/wk chrg) or tweet @AbsoluteRadio",
"name": "No Repeat Guarantee"
},
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-27T16:00:00",
"locations": [
{
"scheduledStart": "2020-03-27T16:00:00Z",
"scheduledStop": "2020-03-27T19:00:00Z"
}
],
"description": "The Hometime show, brought to you by Andy Bush & Richie Firth. 3 hours of nonsense presented by 2 confused dads. Apologies in advance.",
"name": "Hometime with Bush & Richie"
},
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-27T19:00:00",
"locations": [
{
"scheduledStart": "2020-03-27T19:00:00Z",
"scheduledStop": "2020-03-27T22:00:00Z"
}
],
"description": "Claire Sturgess is tarting your Friday night with a bang, playing you all the undisputed classics of the 1980s. Get your leg warmers on and frizz that hair! Tweet @AbsoluteRadio",
"name": "Absolute 80s Greatest Hits"
},
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-27T22:00:00",
"locations": [
{
"scheduledStart": "2020-03-27T22:00:00Z",
"scheduledStop": "2020-03-28T04:00:00Z"
}
],
"description": "Dan Noble plays the best songs from across the Absolute Radio network. From 60s to 00s, there'll be tracks you've not heard for ages!",
"name": "Through The Decades"
},
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-28T04:00:00",
"locations": [
{
"scheduledStart": "2020-03-28T04:00:00Z",
"scheduledStop": "2020-03-28T08:00:00Z"
}
],
"description": "Early start today? No bother because Chris Martin is here to kick-start your morning with some brilliant music.",
"name": "Early Breakfast"
},
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-28T08:00:00",
"locations": [
{
"scheduledStart": "2020-03-28T08:00:00Z",
"scheduledStop": "2020-03-28T11:00:00Z"
}
],
"description": "Frank, Emily and Alun are here to make you smile on a Saturday morning. Stick the kettle on and join them for a cuppa.",
"name": "The Frank Skinner Show"
},
{
"id": "sp:/crid://planetradio.co.uk;dab/abr2020-03-28T11:00:00",
"locations": [
{
"scheduledStart": "2020-03-28T11:00:00Z",
"scheduledStop": "2020-03-28T14:00:00Z"
}
],
"description": "Whatever you're doing with your weekend, Sarah Champion has your playlist sorted with brilliant music both new and old.",
"name": "Sarah Champion"
}
],
"meta": {
"country": "826",
"rpuid": "826100",
"paginated": true,
"nesting": false,
"fromCache": false,
"cacheExpiresAt": 1585318585827,
"count": 7,
"pageSize": 7,
"lastPage": true,
"firstPage": true,
"totalPages": 1,
"pageNumber": 0
}
}
],
"meta": {
"nesting": true,
"paginated": false,
"dataType": "schedule",
"count": 1,
"fromCache": false,
"cacheExpiresAt": null
}
}
The returned response body consists of a meta
and data
object.
The possible meta
field values for this endpoint are:
FIELD | VALUE |
---|---|
paginated |
Optional, Boolean. Sets how or if results are grouped into pages. This value will be set to true for each station object returned. Each station is an object with its own meta object, so this results in nested pagination. For more information on pagination, see the API Documentation index. |
nesting |
Optional, Boolean. Indicates whether full data objects are nested within other objects. For this endpoint this value is always set to true . For more information on nesting, see the API Documentation index. |
dataType |
Object type returned by the request. In this case it is schedule . |
count |
Optional, string. A number describing how many items are in the data set. |
fromCache |
Optional, Boolean. Indicates whether this data came from cached data. For more information on caching, please see the API Documentation index. |
cacheExpiresAt |
Optional. UNIX timestamp indicating when the cache will expire. For more information on caching, please see the API Documentation index. |
The possible data
field values for this endpoint are:
FIELD | VALUE |
---|---|
id |
String. A unique identifier which identifies a programme within the schedule |
locations |
Array. An array of schedule start and end dates which indicate when the programme is expected to be broadcast |
locations ↳ scheduledStart |
Date. RFC3339-formatted datestamp describing the date and time when the programme is likely to be broadcast |
locations ↳ scheduledStop |
Date. RFC3339-formatted datestamp describing the date and time when the programme will end. |
description |
Optional, String. A short (128 char) description of the programme |
name |
String. The name of the programme |
multimedia |
Array. Where provided, this is an array of visual assets such as episode or series images depicting the programme. There may be none, one or many images available |
multimedia ↳ url |
URL. The URL of the visual asset. |
multimedia ↳ mimeValue |
String. A string describing the MIME type of the visual asset such as image/jpeg |
multimedia ↳ width |
Integer. The width of the visual asset in pixels. |
multimedia ↳ height |
Integer. The height of the visual asset in pixels. |
multimedia ↳ index |
Integer. Where multiple images are provided, this value indicates the image to attempt to use first, where the lower the value, the higher the priority. |