Media UK

API

> > We also produce a list of our directory content.

Here is a very small API for grabbing "listen-now" data for all radio and TV services within Media UK. This is designed to easily return official web players for radio and TV services. Roughly the same queries are used at http://www.mediauk.com/listen

This is designed to be similar to the BBC API, for ease of use. However, this API only supports the 'simple' format, and has extensions to the current BBC API which are currently under discussion.

This is a prototype.

broadcast.channel.list

Arguments: none

Example request:
http://www.mediauk.com/api/broadcast.muk?method=broadcast.channel.list

Example response:
<channel channel_id="28176" name="BBC Parliament" type="tv"/>
<channel channel_id="307" name="BBC Radio Wiltshire" type="radio" />
<channel channel_id="258" name="107.2 Win FM" type="radio" />

Notes:
Channels are returned in intelligent alphabetical order. Radio stations ignore prefixes like 'BBC', 'Radio', and frequencies.

broadcast.channel.getLocations

Arguments: channel_id (required) - identifier for channel to retrieve information on

Example request:
http://www.mediauk.com/api/broadcast.muk?method=broadcast.channel.getLocations&channel_id=1

Example response:
<location>
<type>text/html</type>
<width>686</width>
<height>360</height>
<url>http://player.virginradio.co.uk/core/player2/?service=vr</url>
</location>

Notes:
You can edit this information within the Media UK directories.
Users will normally be expected to have Windows Media Player and/or Real Player installed.

Terms of use

This work is licenced under a Creative Commons Licence. Media UK defines commercial use as use by a commercial company for profit (so use on a blog which contains Google AdSense is fine). Attribution must include the text "Media UK" and a hyperlink to www.mediauk.com.

For more information and feedback

Please contact us.