Production Server:
https://api.mtvnn.com/v2/
Staging Server:
https://staging.sensei.mtvnn.com/v2/
https://api.mtvnn.com/v2/site/<APIKEY>/<COUNTRYID>/...
Country ID | API Key |
---|---|
BE/NL/LU | w3ap440ada |
DE/AT/CH | z9pce5mcsm |
SE/DK | wzni63gbjz |
PL | ejn2gf7esh |
Get single episode
GET /{Language}/episodes/{EpisodeID}.json
Get episodes
GET /{Language}/franchises/{FranchiseID}/episodes.json?page=0&per=10000
Get info page
GET /{Language}/content_blocks/{InfoType}{Language}.json
Get next episode release data
GET /{Language}/content_blocks/wla_upcoming_content_{Language}.json
Get playlist
GET /{Language}/local_playlists/{PlaylistID}.json?video_format=m3u8
Get season by ID
GET {Language}/franchises/{FranchiseID}/shows/seasons/{SeasonID}/episodes.json
Get seasons
GET /{Language}/franchises/{FranchiseID}/shows/seasons.json?page=0&per=100
Get teaser collection
GET /{Language}/teaser_collections.json?details=true&language_fallback=true
-
{Franchise ID}:
471
(-> South Park) -
{Language}:
Country ID {Language} SE/DK en BE/NL/LU nl DE/AT/CH de PL pl -
{SeasonID}: You can get this ID by requesting for example
seasons.json
using the appropriate Season ID. -
{PlaylistID}: You can get this ID by requesting an API call which returns episode details.
-
{InfoType}: Type of the info page
Description Value Behavioral Ad Delivery Policy wla_oba_ Imprint and Support wla_imprint_ Copyright wla_copyright_ Privacy Policy wla_privacy_ Terms and Conditions wla_tcs_
We need to get a link to the playlist file, but to do that we also need the Playlist ID of the episode.
You can get this id by calling for example:
GET /{Language}/episodes/{EpisodeID}.json
Look in the JSON response for a local_playlist
object. The value of the key id
is in this case the playlist id. Next, we can call another api function to get the url to the m3u8 file:
GET /{Language}/local_playlists/{PlaylistID}.json?video_format=m3u8
This time, you can find the value in the local_playlist_videos
object, next to the key url
.
However, this is not the actual playlist file we want. This file contains several links to the 'real' m3u8 files, every link should point to a playlist/hls-stream with a different resolution/quality factor.
Follow one of these links (preferably the most highest quality one) and you have the m3u8 playlist file of the requested episode.
Written by ThePBone