Radio & Music Services
We encapsulate Radio & Music business logic for iPlayer Radio and BBC Music products on all platforms. We add value by reliably providing the right blend of…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
We encapsulate Radio & Music business logic for iPlayer Radio and BBC Music products on all platforms. We add value by reliably providing the right blend of metadata needed by clients.
Endpoints 75
Experience
- GETHomepage Experience
/experience/homepageHomepage Experience
Playspace
- GETSuggested Playspace Container
/my/playspace/containers/suggested?previous_pid=string&previous_container=stringSuggested Playspace Container - GETPlayspace Container by ID
/my/playspace/containers/:idPlayspace Container by ID
Categories
- GETList of categories
/categories?kind=promotedRetrieve Categories - GETCategory by ID
/categories/:idRetrieve Categories by ID
Networks
- GETNetworks
/radio/networks.json?preset=true&international=trueAll iPlayer Radio networks - contains business logic for masterbrand and service relationships
Broadcasts
- GETBroadcasts
/broadcasts?offset=0&limit=0&service_id=string&date=string&sort=start_atAll broadcasts - GETLatest Broadcasts
/broadcasts/latest?offset=0&limit=0&service_id=string&on_air=now&next=string&previous=string&sort=start_atBroadcasts for the current day - GETBroadcasts by PID
/broadcasts/:pidFind broadcast by PID
Collections
- GETCollection Members
/collections/:pid/members?offset=0&limit=0Episodes and Clips from Collection
Podcasts
- GETAll Podcasts
/podcasts?offset=0&limit=0&sort=title&network=string&network_url_key=string&category=string&q=string&coverage=localRetrieve all Podcasts - GETFeatured Podcasts
/podcasts/featuredRetrieve featured podcasts - GETPodcast
/podcasts/:pid?offset=0&limit=0Retrieve data about the podcast with the supplied PID - GETPodcast Episodes
/podcasts/:pid/episodes?offset=0&limit=0Retrieve all episodes for a specific podcast
Programmes
- GETRecommended Programmes
/my/programmes/recommendations?offset=0&limit=0&rights=webRecommended Programmes from the Audience Platforms' Recomendations Service - GETPopular Episodes & Clips
/radio/popular?type=episode&distinct=tleo&network=string&network_url_key=string&category=string&format=string&group=tv&media_type=audio&container=string&media_set=pc&q=stringRetrieve Popular Episodes & Clips - GETRadio programmes
/radio/programmes?kind=tleo&network=string&network_url_key=string&category=string&sort=available_from_date&container=string&type=brandProvides a paginated list of programmes by PID (brand, series, episode and clip). Accepts various filters and sorting methods. N.B. Swagger schemas cannot… - GETAvailable radio programme by Pid
/radio/programmes/:pidFind 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…
Personalised Categories
- GETList of followed categories
/my/categories/follows?offset=0&limit=0List of followed categories for a given user. - POSTFollow category
/my/categories/follows - DELETEUnfollow category
/my/categories/follows
Personalised Networks
- GETList of followed networks
/my/networks/follows?offset=0&limit=0List of followed networks for a given user. - POSTFollow network
/my/networks/follows?offset=0&limit=0 - DELETEUnfollow network
/my/networks/follows?offset=0&limit=0
Personalised Plays
- POSTWrite Play Event
/my/plays
Radio
- GETFavourite Episodes and Clips
/my/radio/favourites?offset=0&limit=0&sort=programme_titles&show_all_activity=trueList 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… - PUTFavourite Episodes and Clips
/my/radio/favouritesUpdate user favourites N.B. Any HTML tags submitted in metadata will be removed - POSTFavourite Episodes and Clips
/my/radio/favouritesAdd User favourites N.B. Any HTML tags submitted in metadata will be removed - GETFavourite Episodes and Clips by Type
/my/radio/favourites/:type?sort=programme_titles&show_all_activity=true&offset=0&limit=0List 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… - GETFavourite Episode or Clip
/my/radio/favourites/:type/:pid?show_all_activity=trueCheck 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… - PUTFavourite Episode or Clip
/my/radio/favourites/:type/:pidUpdate user favourite N.B. Any HTML tags submitted in metadata will be removed - POSTFavourite Episode or Clip
/my/radio/favourites/:type/:pidAdd User favourite N.B. Any HTML tags submitted in metadata will be removed - DELETEFavourite Episode or Clip
/my/radio/favourites/:type/:pidRemove User favourite - GETFollowed Brands and Series
/my/radio/follows?offset=0&limit=0&sort=programme_titles&show_all_activity=trueList 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… - PUTFollowed Brands and Series
/my/radio/followsUpdate 'brands' or 'series' items from a users iPlayer Radio follows N.B. Any HTML tags submitted in metadata will be removed - POSTFollowed Brands and Series
/my/radio/followsAdd 'brand' or 'series' items to a users iPlayer Radio follows N.B. Any HTML tags submitted in metadata will be removed - GETFollowed Brands or Series by Type
/my/radio/follows/:type?sort=programme_titles&offset=0&limit=0&show_all_activity=trueList 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… - GETFollowed Brand or Series
/my/radio/follows/:type/:pidCheck to see if a single brand or series entity is in a users follows - determines UX of add button. - PUTFollowed Brand or Series
/my/radio/follows/:type/:pidUpdate 'brand' or 'series' items from a users iPlayer Radio follows N.B. Any HTML tags submitted in metadata will be removed - POSTFollowed Brand or Series
/my/radio/follows/:type/:pidAdd 'brand' or 'series' items from a users iPlayer Radio follows N.B. Any HTML tags submitted in metadata will be removed - DELETEFollowed Brand or Series
/my/radio/follows/:type/:pidRemove 'brand' or 'series' items from a users iPlayer Radio follows - GETPlayed Episode or Clip
/my/radio/plays?offset=0&limit=0&sort=programme_titles&show_all_activity=trueReturns 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…
Music
- GETPopular Artists
/music/popular/artists?since=string&until=string&decomposed=true&offset=0&limit=0List of Most Popular artists from BBC Music. - GETSingle Artist Popularity
/music/popular/artists/:id?since=string&until=string&decomposed=truePopularity Artist By Id - GETPopular Playlists
/music/popular/playlists?since=string&until=string&decomposed=true&offset=0&limit=0List of Most Popular playlists from BBC Music. - GETSingle Playlist Popularity
/music/popular/playlists/:id?since=string&until=string&decomposed=truePopular playlist by Id - GETPopular Tracks
/music/popular/tracks?since=string&until=string&network=string&programme=string&artist=string&decomposed=true&offset=0&limit=0List of popular tracks for BBC Music. Filter by time, network, artist, playlist or programme. - GETSingle Track Popularity
/music/popular/tracks/:id?since=string&until=string&network=string&programme=string&artist=string&decomposed=truePopular Track for BBC Music - GETFavourite Tracks or Clips
/my/music/favourites?offset=0&limit=0&action=favourited&music-data=trueList of favourited tracks and clips for a given user for BBC Music. - PUTFavourite Tracks or Clips
/my/music/favouritesUpdate tracks or clips from a BBC Music user favourites. N.B. Any HTML tags submitted in metadata will be removed - POSTFavourite Tracks or Clips
/my/music/favouritesAdd multiple tracks and/or clips to a BBC Music user's favourites. N.B. Any HTML tags submitted in metadata will be removed - GETFavourite Tracks or Clips by Type
/my/music/favourites/:type?action=favourited&offset=0&limit=0List of favourited tracks or clips for a given user for BBC Music. - GETFavourite Track or Clip
/my/music/favourites/:type/:idCheck to see if a single track or clip entity is in a users favourites - determines UX of add button. - PUTFavourite Track or Clip
/my/music/favourites/:type/:idUpdate tracks or clips from a BBC Music user favourites. N.B. Any HTML tags submitted in metadata will be removed - POSTFavourite Track or Clip
/my/music/favourites/:type/:idAdd track or clip to a BBC Music user favourites. N.B. Any HTML tags submitted in metadata will be removed - DELETEFavourite Track or Clip
/my/music/favourites/:type/:idDelete track or clip from a BBC Music user favourites. - GETFollowed Networks, Categories, Artists, Playlists and Genres
/my/music/follows?action=followed&music-data=true&music_context=events&music_within_uk=true&offset=0&limit=0List of followed networks, categories, artists, playlists and genres for a given user for BBC Music. - PUTFollowed Networks, Categories, Artists, Playlists and Genres
/my/music/follows?action=followed&music-data=true&music_context=events&music_within_uk=trueUpdate networks, categories, artists, playlists, networks, genres or services in a users follows N.B. Any HTML tags submitted in metadata will be removed - POSTFollowed Networks, Categories, Artists, Playlists and Genres
/my/music/follows?action=followed&music-data=true&music_context=events&music_within_uk=trueAdd networks, categories, artists, playlists, networks, genres or services in a users follows N.B. Any HTML tags submitted in metadata will be removed - GETFollowed Networks, Categories, Artists, Playlists and Genres by Type
/my/music/follows/:type?action=followed&music-data=true&music_context=events&music_within_uk=true&offset=0&limit=0List of followed networks, categories, artists, playlists, networks, genres, categories or services for a given BBC Music user. - GETFollowed Network, Category, Artist, Playlist and Genre
/my/music/follows/:type/:id?music-data=true&music_context=events&music_within_uk=trueCheck to see if a single network, category, artist, playlist, network, genre or service entity is in a users follows - determines UX of add button. - PUTFollowed Network, Category, Artist, Playlist and Genre
/my/music/follows/:type/:id?music-data=true&music_context=events&music_within_uk=trueUpdate 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… - POSTFollowed Network, Category, Artist, Playlist and Genre
/my/music/follows/:type/:id?music-data=true&music_context=events&music_within_uk=trueAdd 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… - DELETEFollowed Network, Category, Artist, Playlist and Genre
/my/music/follows/:type/:id?music-data=true&music_context=events&music_within_uk=trueRemove a single network, category, artist, playlist, network, genre or service entity is in a users follows
Music Export
- GETMusic Exports
/my/music/export?offset=0&limit=0Returns status of all previous third party export actions for a given BBC Music user. - GETMusic Export Jobs
/my/music/exports/jobs?over16=true&vendor=spotifyAll items associated to a users export request - POSTMusic Export Jobs
/my/music/exports/jobs?over16=true&vendor=spotifyCreate Export Job for a user - GETMusic Export Tracks
/my/music/exports/tracks?over16=true&offset=0&limit=0&vendor=spotify&status=failedRetrieves vendor and status specific tracks - GETMusic Export Preferences
/my/music/preferences/exportReturns export preferences (e.g. 3rd party vendors, partner id's) for a given BBC Music user. - POSTMusic Export Preferences
/my/music/preferences/exportCreate export preferences (e.g. 3rd party vendors, partner id's) for a given BBC Music user. - DELETEMusic Export Preferences
/my/music/preferences/exportRemove export preferences (e.g. 3rd party vendors, partner id's) for a given BBC Music user. - GETMusic Export Vendor Preferences
/my/music/preferences/export/:vendorReturns vendor specific export preferences for a given BBC Music user. - PUTMusic Export Vendor Preferences
/my/music/preferences/export/:vendorUpdate vendor specific export preferences for a given BBC Music user. - POSTMusic Export Vendor Preferences
/my/music/preferences/export/:vendorCreate Vendor specific export preferences (e.g. 3rd party vendors, partner id's) for a given BBC Music user. - DELETEMusic Export Vendor Preferences
/my/music/preferences/export/:vendorRemove Vendor specific export preferences (e.g. 3rd party vendors, partner id's) for a given BBC Music user.
API details
- Base URL
https://rms.api.bbc.co.uk- Authentication
- None declared in the description
- Operations
- 75 operations on 45 pathsGET 44POST 14PUT 9DELETE 8
- Main resources
- Music 22Radio 17Music Export 11Podcasts 4Programmes 4Broadcasts 3Personalised Categories 3Personalised Networks 3Categories 2Playspace 2
- Response formats
application/json- Description format
- Swagger 2.0, API version
1.0.0 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Radio & Music Services in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Radio & Music Services collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Homepage Experience” (GET /experience/homepage), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Radio & Music Services?
We encapsulate Radio & Music business logic for iPlayer Radio and BBC Music products on all platforms. We add value by reliably providing the right blend of… It is listed under Media & content and has 75 endpoints.
Who publishes the Radio & Music Services?
It is listed from BBC's public API description (an OpenAPI document), not published by BBC on Swastik Codes. Anyone who controls bbc.co.uk can claim the profile by adding a DNS TXT record.
What is the base URL of the Radio & Music Services?
Requests go to https://rms.api.bbc.co.uk. Endpoint paths are added to this base URL.
How do I authenticate with the Radio & Music Services?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Radio & Music Services have?
75 operations on 45 paths (44 GET, 14 POST, 9 PUT, 8 DELETE). The largest groups are Music, Radio, Music Export, Podcasts.
Is forking the Radio & Music Services free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.