TvShows

You get access to all the Tv Shows information. Use the searchShowList API to retreive the show ID. This can be used for the other API's.

Method
Description
GET
tvshowsByAlphabeticalhttps://api.srgssr.ch/videometadata/v2/tv_shows/alphabetical
Returns TV shows according to an editorially managed list.
GET
searchShowListhttps://api.srgssr.ch/videometadata/v2/tv_shows
Returns the results matching the given search criteria.
GET
tvShowhttps://api.srgssr.ch/videometadata/v2/tv_shows/{showId}
Returns metatdata for a TV show. You can pick showId from searchShowList API.

VideoShows

You get access to all the Video Show information. Use the searchVideoList API to retreive the video ID. This can be used for the other API's.

Method
Description
GET
mostClickedhttps://api.srgssr.ch/videometadata/v2/most_clicked
Returns the videos which where most clicked in the last 24 hours.
GET
recommendedhttps://api.srgssr.ch/videometadata/v2/{videoId}/recommended
Returns the recommended videos for a given video based on the recommendation engine calculation, ordered by score. The list will be supplemented with trending videos. You can get videoid from searchVideoList API.
GET
expiringsoonhttps://api.srgssr.ch/videometadata/v2/expiring_soon
Returns videos which will expire within the next 28 days. Sorted by the expiration date in ascending order.
GET
editorialrecomendationhttps://api.srgssr.ch/videometadata/v2/editorial_recomendation
Returns a list of editorially selected videos.
GET
trendinghttps://api.srgssr.ch/videometadata/v2/trending_picks
Returns videos from editorial picks (except rtr) and complete list with trending videos. The parameter maxCountEditorPicks allows to define number of editorial picks.
GET
mediaCompositionhttps://api.srgssr.ch/videometadata/v2/{videoId}/mediaComposition
Returns detailed metatdata for a video. On the chapter section there are information to play the video. You need to get videoid from EpisodeComposition (/latest_episodes/shows/{showId} API.
GET
searchVideoListhttps://api.srgssr.ch/videometadata/v2/search
Returns the results matching the given search criteria.

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/videometadata/v2/livestreams
Returns a list livestream medias.
GET
videobylivestreamIdshttps://api.srgssr.ch/videometadata/v2/livestreamIds
Returns the videos requested by ids parameter. You can pick livestream ID from livestreams API.

TvChannels

You get access to all the Tv Channels information. Use the API to retreive the Channel ID. This can be used for the channelEdpisodes API's.

Method
Description
GET
channelListhttps://api.srgssr.ch/videometadata/v2/tv_channels
Returns a list of TV channels.

Topics

You get access to all the Topics information. Use the API to retreive the video ID. This can be used for the other API's.

Method
Description
GET
topicListhttps://api.srgssr.ch/videometadata/v2/tv_topics
Returns tv topics such as e.g. 'news', 'sport', etc.
GET
latestByTopichttps://api.srgssr.ch/videometadata/v2/latest_topics/{topicId}
Returns the latest videos filtered by topic. You need to get topicId from Topic List API listed below.

Episodes

Episodes TV and Radio

Method
Description
GET
latestEpisodeshttps://api.srgssr.ch/videometadata/v2/latest_episodes
Returns the latest full-length videos filtered by an editorially managed list of shows.
GET
episodeCompositionhttps://api.srgssr.ch/videometadata/v2/latest_episodes/shows/{showId}
Returns the latest episodes with a list of media for the given show. Only episodes with playable media are returned. You need to get showId from the SearchResultListShow API.
GET
channelEdpisodeshttps://api.srgssr.ch/videometadata/v2/episodes_now_next/channels/{channelId}
Returns the currently playing and upcoming episode. You can pick channelId from channelList API
GET
episodesByDatehttps://api.srgssr.ch/videometadata/v2/episodes_by_date/{day}
Returns a list of the latest episodes for the given date.