API Reference

Returns data about one or more specified stations

/stations/{rpuids}

Returns information about one or more specific stations objects, identified by their rpuid parameters.

The information returned in the results can be specified by the include parameter.

Endpoint

Base URL: https://api.radioplayer.org/v2/stations/{rpuids}

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

PATH PARAMETER VALUE
{rpuids} Returns one or more station objects identified by their rpuid, or unique identifier.

Query Parameters

Look up stations by rpuid

/v2/stations/3722,372101



Lookup station with include parameters

/v2/stations/372101?include=social,images
QUERY PARAMETER VALUE
{rpuids} Compulsory. Specifies one or more station objects by their rpuid, which can be requested using a comma separated list.
include Optional. Specifies which fields are returned by the request for a station object, defined by a comma separated list.

Available values are:
  • ids (rpuids are always returned whether specified or not)
  • detail (includes name, description and country)
  • bearers (includes bearerIds)
  • social (includes social ids)
  • streams (includes livestream URLs)
  • images (includes any URLs for images, such as logos).
If include is not applied, all fields will be returned for the station object.

Response

When successful, the HTTP status code in the response header is 200 OK. One or more station objects 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.

The returned response body consists of a meta and data object.

Example Response Body

    {
    "data": [
        {
        "name": "RTÉ 2fm",
        "description": "The home of Irish talent, great festivals and live music.",
        "liveStreams": [
            {
            "streamSource": {
                "url": "https://www.rte.ie/manifests/2fm.m3u8",
                "mimeValue": "audio/x-mpegurl"
            },
            "bitRate": {
                "target": 48000
            }
            },
            {
            "streamSource": {
                "url": "https://av.rasset.ie/av/live/radio/playlist/2fm.m3u",
                "mimeValue": "audio/mpeg"
            },
            "bitRate": {
                "target": 96000
            }
            }
        ],
        "socialIds": [
            {
            "type": "twitter",
            "uid": "rte2fm"
            },
            {
            "type": "facebook",
            "uid": "2fmofficial"
            }
        ],
        "alphanumericKey": "r",
        "multimedia": [
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_600x600_2018-11-22-16-45-26-675.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 600,
            "height": 600
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_86x48_2016-01-11-09-45-02-437.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 86,
            "height": 48
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_288x162_2016-01-11-09-45-02-35.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 288,
            "height": 162
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_128x128_2018-11-30-10-15-26-615.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 128,
            "height": 128
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_1920x1080_2018-11-22-16-45-26-813.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 1920,
            "height": 1080
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_74x41_2016-01-11-09-45-02-472.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 74,
            "height": 41
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_160x90_2016-01-11-09-45-02-529.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 160,
            "height": 90
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_320x240_2018-11-30-10-15-27-51.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 320,
            "height": 240
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_112x32_2018-11-30-10-15-27-90.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 112,
            "height": 32
            },
            {
            "url": "http://ierpimagecache.s3.amazonaws.com/image/2_32x32_2018-11-30-10-15-27-114.png",
            "mimeValue": "image/png",
            "language": "en",
            "width": 32,
            "height": 32
            }
        ],
        "country": "372",
        "rpuid": "3722",
        "bearers": [
            {
            "id": "fm:2e3.2202.09050",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09140",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09200",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09040",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09130",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09060",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09220",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09210",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09160",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09170",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09150",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09100",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09070",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09700",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09180",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09110",
            "cost": 0
            },
            {
            "id": "dab:2e3.2e01.2242.0",
            "cost": 0,
            "mimeValue": "audio/mpeg"
            },
            {
            "id": "fm:2e3.2202.09190",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09120",
            "cost": 0
            },
            {
            "id": "dab:2e3.2e01.2262.0",
            "cost": 0,
            "mimeValue": "audio/mpeg"
            },
            {
            "id": "fm:2e3.2202.09090",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09080",
            "cost": 0
            },
            {
            "id": "fm:2e3.2202.09240",
            "cost": 0
            },
            {
            "id": "dab:2e3.2e04.2811.0",
            "cost": 0,
            "mimeValue": "audio/mpeg"
            },
            {
            "id": "dab:2e3.2e01.2202.0",
            "cost": 0,
            "mimeValue": "audio/mpeg"
            }
        ],
        "phoneticInputs": [
            {
            "id": "1513074452060_3722_i",
            "type": "pidgin",
            "value": "RTE 2FM",
            "exclude": []
            },
            {
            "id": "1513074491976_3722_i",
            "type": "pidgin",
            "value": "RTE radio 2",
            "exclude": []
            },
            {
            "id": "1511533989509_272_i",
            "type": "pidgin",
            "value": "radio 2",
            "exclude": []
            },
            {
            "id": "1513074937830_3722_i",
            "type": "pidgin",
            "value": "or TE radio 2FM",
            "exclude": []
            },
            {
            "id": "1513074402269_3722_i",
            "type": "pidgin",
            "value": "RTE 2",
            "exclude": []
            },
            {
            "id": "1513074832108_3722_i",
            "type": "pidgin",
            "value": "RTE radio 2FM",
            "exclude": []
            },
            {
            "id": "1511533989508_66_i",
            "type": "pidgin",
            "value": "2",
            "exclude": []
            },
            {
            "id": "1513074825866_3722_i",
            "type": "pidgin",
            "value": "RTE radio 2 FM",
            "exclude": []
            },
            {
            "id": "1511533989508_162_i",
            "type": "pidgin",
            "value": "2 FM",
            "exclude": []
            },
            {
            "id": "1513074898338_3722_i",
            "type": "pidgin",
            "value": "or TE 2FM",
            "exclude": []
            },
            {
            "id": "1511533989509_302_i",
            "type": "pidgin",
            "value": "2FM",
            "exclude": []
            },
            {
            "id": "1513074891476_3722_i",
            "type": "pidgin",
            "value": "or TE 2 FM",
            "exclude": []
            },
            {
            "id": "1513074908246_3722_i",
            "type": "pidgin",
            "value": "or TE radio 2",
            "exclude": []
            },
            {
            "id": "1513074884115_3722_i",
            "type": "pidgin",
            "value": "or TE 2",
            "exclude": []
            },
            {
            "id": "1511533989508_76_i",
            "type": "pidgin",
            "value": "radio 2 FM",
            "exclude": []
            },
            {
            "id": "1513074926853_3722_i",
            "type": "pidgin",
            "value": "or TE radio 2 FM",
            "exclude": []
            },
            {
            "id": "1513074427063_3722_i",
            "type": "pidgin",
            "value": "RTE 2 FM",
            "exclude": []
            }
        ],
        "phoneticOutputs": [
            {
            "id": "1524094865388_3722_o",
            "type": "pidgin",
            "value": "R. T. E. 2 F. M.",
            "exclude": []
            }
        ]
        }
    ],
    "meta": {
        "nesting": false,
        "paginated": false,
        "dataType": "stations",
        "count": 1,
        "fromCache": true,
        "cacheExpiresAt": 1585306833078
    }
    }

The possible meta field values for this endpoint are:

FIELD VALUE
paginated Optional, Boolean. Sets how or if results are grouped into pages.

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 false.

For more information on nesting, see the API Documentation index.
dataType Object type returned by the request. In this case it is stations.
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 Epoch timestamp indicating when the cache will expire.

For more information on caching, please see the API Documentation index.

Multiple data objects are to be expected - one per station. The possible data field values for this endpoint are:

FIELD VALUE
name String. The full name of the radio station
description String. A description relating to the station. Typically a slogan or strapline under 128 characters.
livestream Array. An array containing one or many live streaming assets.
streamSource Array. An array describing a single audio stream.
↳ url URL. The URL of the live stream resource.
mimeValue String. The MIME type of the stream which indicates the stream codec and format.
bitrate
↳ target
Integer. A number, in bits per second, indicating the bitrate of the stream.
socialIds Array, optional. An array of one or more social media identifiers
↳ type Constant. Can be ‘twitter’ or ‘facebook’
↳ uid String. The corresponding social media ID.
alphanumericKey String. Where a station is listed in an alphabetical list, this key indicates the letter of the alphabet under which the content should appear.
multimedia Array. An array of one of one or many visual assets (typically station logos)
↳ url String. URL of the image asset
↳ language String. Language of the image asset. Useful for image that may display lines of text
↳ type String, constant. This is always logo_unrestricted as per the DAB-EPG spec
↳ width Integer. The number of pixels representing the width of the image
↳ height Integer. The number of pixels representing the height of the image.
rpuid Integer. A unique identifier relating to the radio station that published the OD content
country Integer. ISO numeric country code of the station that published the OD content.
bearers Array, Optional. An array of broadcast transmission parameters. See Section 5 of ETSI TS102818 for details
↳ id String, URI. An individual broadcast bearer.
↳ cost Integer. The ‘cost’ of the bearer (see ETSI TS102818)
phoneticInputs Array, optional. An array of synonyms - typically alternative names for a station, or spellings to assist recognition by voice systems.
↳ id String. A unique identifier for the entry.
↳ type Constant. The type of phonetic schema used. Usually ‘pidgin’; ‘ssml’ also supported
↳ value String. The phonetic entry itself.
↳ exclude Array. An array of platforms which should disregard this entry. If empty, assume use by all voice platforms is allowed.
phoneticOutput Array, optional. An array of phonetics to assist voice systems with the correct pronunciation of a station name.
↳ id String. A unique identifier for the entry.
↳ type Constant. The type of phonetic schema in use. Either ‘pidgin’ or ‘ssml’
↳ value String. The value of the phonetic entry itself.
↳ exclude Array, optional. An array of platforms which should disregard this entry. If empty, assume use by all voice platforms is allowed.