Radio & Music Services

All Podcasts

Retrieve all Podcasts

Available radio programme by Pid

Find programmes by PID (brand, series, episode and clip) N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining results as an array of Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Broadcasts

All broadcasts

Broadcasts by PID

Find broadcast by PID

Category by ID

Retrieve Categories by ID

Collection Members

Episodes and Clips from Collection

Favourite Episode or Clip

Remove User favourite

Favourite Episode or Clip

Check to see if a single clip or episode entity is in a users favourites - determines UX of add button. N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining data as a Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Favourite Episode or Clip

Add User favourite N.B. Any HTML tags submitted in metadata will be removed

Favourite Episode or Clip

Update user favourite N.B. Any HTML tags submitted in metadata will be removed

Favourite Episodes and Clips

List of favourited episodes and clips for a given user for iPlayer Radio. N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining data as a Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Favourite Episodes and Clips by Type

List of followed 'clips' or 'episode' items for a given iPlayer Radio user N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining data as a Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Favourite Track or Clip

Delete track or clip from a BBC Music user favourites.

Favourite Track or Clip

Check to see if a single track or clip entity is in a users favourites - determines UX of add button.

Favourite Track or Clip

Add track or clip to a BBC Music user favourites. N.B. Any HTML tags submitted in metadata will be removed

Favourite Track or Clip

Update tracks or clips from a BBC Music user favourites. N.B. Any HTML tags submitted in metadata will be removed

Favourite Tracks or Clips

List of favourited tracks and clips for a given user for BBC Music.

Favourite Tracks or Clips by Type

List of favourited tracks or clips for a given user for BBC Music.

Featured Podcasts

Retrieve featured podcasts

Follow category

Follow network

Followed Brand or Series

Remove 'brand' or 'series' items from a users iPlayer Radio follows

Followed Brand or Series

Check to see if a single brand or series entity is in a users follows - determines UX of add button.

Followed Brand or Series

Add 'brand' or 'series' items from a users iPlayer Radio follows N.B. Any HTML tags submitted in metadata will be removed

Followed Brand or Series

Update 'brand' or 'series' items from a users iPlayer Radio follows N.B. Any HTML tags submitted in metadata will be removed

Followed Brands and Series

List of favourited brands and series for a given user for iPlayer Radio. N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining data as a Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Followed Brands or Series by Type

List of followed 'brand' or 'series' items for a given iPlayer Radio user N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining data as a Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Followed Network, Category, Artist, Playlist and Genre

Remove a single network, category, artist, playlist, network, genre or service entity is in a users follows

Followed Network, Category, Artist, Playlist and Genre

Check to see if a single network, category, artist, playlist, network, genre or service entity is in a users follows - determines UX of add button.

Followed Network, Category, Artist, Playlist and Genre

Add a single network, category, artist, playlist, network, genre or service entity is in a users follows N.B. Any HTML tags submitted in metadata will be removed

Followed Network, Category, Artist, Playlist and Genre

Update a single network, category, artist, playlist, network, genre or service entity is in a users follows N.B. Any HTML tags submitted in metadata will be removed

Followed Networks, Categories, Artists, Playlists and Genres

List of followed networks, categories, artists, playlists and genres for a given user for BBC Music.

Followed Networks, Categories, Artists, Playlists and Genres by Type

List of followed networks, categories, artists, playlists, networks, genres, categories or services for a given BBC Music user.

Homepage Experience

Homepage Experience

Latest Broadcasts

Broadcasts for the current day

List of categories

Retrieve Categories

List of followed categories

List of followed categories for a given user.

List of followed networks

List of followed networks for a given user.

Networks

All iPlayer Radio networks - contains business logic for masterbrand and service relationships

Played Episode or Clip

Returns mixed episode and clip plays for a given BBC iPlayer radio user. N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining data as a Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Playspace Container by ID

Playspace Container by ID

Podcast

Retrieve data about the podcast with the supplied PID

Podcast Episodes

Retrieve all episodes for a specific podcast

Popular Artists

List of Most Popular artists from BBC Music.

Popular Episodes & Clips

Retrieve Popular Episodes & Clips

Popular Playlists

List of Most Popular playlists from BBC Music.

Popular Tracks

List of popular tracks for BBC Music. Filter by time, network, artist, playlist or programme.

Radio programmes

Provides a paginated list of programmes by PID (brand, series, episode and clip). Accepts various filters and sorting methods. N.B. Swagger schemas cannot currently handle multiple combinations of object in an array i.e. a mix of Episode and Clip Summaries so we are defining results as an array of Programme Summary here. This will be resolved in V3 with full support for anyOf https://www.openapis.org/blog/2017/01/24/a-new-year-a-new-specification

Recommended Programmes

Recommended Programmes from the Audience Platforms' Recomendations Service

Single Artist Popularity

Popularity Artist By Id

Single Playlist Popularity

Popular playlist by Id

Single Track Popularity

Popular Track for BBC Music

Suggested Playspace Container

Suggested Playspace Container

Unfollow category

Unfollow network

Write Play Event