srgssr-audio

This API provides Audio Metadata (incl. subtitles) from RSI, RTS, RTS, SRF, SWI.
To play audios, you can use the player - http://tp.srgssr.ch/samples/playground. It needs only the ID of the audio you get from the APIs.
For more details on how to integrate and use the player in your HTML page, please visit the SRG Player API Documentation page - http://tp.srgssr.ch/assets/docs/index.html

Audios

Services related to Audios. The service returns valid audioIds that can be used for other services/APIs requiring an audioId

Method
Description
GET
audiosSearchhttps://api.srgssr.ch/audiometadata/v2/audios/search
Returns the audio search result matching the given search criteria. The service returns valid audioId(s) that can be used for other services/APIs requiring an audioId

Livestreams

You get access to all the Livestreams information. Use the Livestream API to retreive the Livestream ID. This can be used in the videobylivestreamIds API's.

Method
Description
GET
livestreamshttps://api.srgssr.ch/audiometadata/v2/livestreams
Returns a list of audio livestream medias with livestreamIds that can be used for getting livestream metadata by Id using audioBylivestreamId api service
GET
audioBylivestreamIdhttps://api.srgssr.ch/audiometadata/v2/livestreams/{livestreamId}
Returns audio livestream metatdata for a valid audio livestreamId. To get a valid livestreamId, please use livestreams api service

RadioChannels

Services returning Radio Channel objects. The service returns list of radio channelIds. When requested by channelId, it returns currently playing and upcoming episode

Method
Description
GET
radioChannelshttps://api.srgssr.ch/audiometadata/v2/radio/channels
Returns a list of Radio channels along with channelIds. The service returns valid channelId(s) that can be used for other services/APIs requiring a channelId
GET
radioChannelBychannelIdhttps://api.srgssr.ch/audiometadata/v2/radio/channels/{channelId}
Returns the currently playing and upcoming episode by channelId. To get a valid channelId, please use radioChannels api service

RadioShows

Services returning Radio Show objects with related information. When requested by showId, it returns show metadata for the given showId

Method
Description
GET
radioShowsSearchhttps://api.srgssr.ch/audiometadata/v2/radioshows/search
Returns the radio show search result matching the given search criteria. showId(s) returned by this service can be used by other services/APIs requiring a valid showId
GET
radioShowsByshowIdhttps://api.srgssr.ch/audiometadata/v2/radioshows/{showId}
Returns radio show metatdata for a valid showId. Please use radioShowsSearch api service to get a valid showId
GET
radioShowsBychannelIdhttps://api.srgssr.ch/audiometadata/v2/radioshows/byChannel
Returns Radio shows according to an editorially managed list. Please use radioChannels api service to get a valid channelId

EpisodeComposition

Services returning Radio Show EpisodeComposition objects. The service returns the latest episodes with a list of media for the given show. Only episodes with playable media are returned by this service

Method
Description
GET
episodeCompositionByshowIdhttps://api.srgssr.ch/audiometadata/v2/episodeComposition/shows/{showId}
Returns the latest episodes with a list of media for the given show. Only episodes with playable media are returned. Please use radioShowsSearch api service to get a valid showId

MediaComposition

Services returning Audio MediaComposition objects. The service returns detailed metatdata for an audio. On the chapter section, there are information to play the audio

Method
Description
GET
mediaCompostionByaudioIdhttps://api.srgssr.ch/audiometadata/v2/mediaComposition/audios/{audioId}
Returns detailed metatdata for an audio. On the chapter section, there are information to play the audio. Please use audiosSearch api service to get valid Ids

Episodes

Episodes TV and Radio

Method
Description
GET
episodesBychannelIdhttps://api.srgssr.ch/audiometadata/v2/episodes/byChannel
Returns the full-length audios for a selected date and a selected channel filtered by an editorially managed list of shows. To get a valid channelId, please use radioChannels api service