API Documentation
Introduction
Welcome to the Rogplay API. This API allows you to create your own Fully edge working Addons, as well as cinema content and customize as you want.
This App made with React Native which works on JavaScript environment, allowing things made easier
Addons
Addons in the RogPlay app enhance user experience by allowing seamless integration of various streams. With this feature, users can add and enjoy a wide range of streaming sources, customizing their entertainment as they prefer. Whether it's movies, live channels, or exclusive content, Addons provide flexibility and personalization, making RogPlay a versatile streaming platform.
Creating Addons
GET https://pastebin.com/raw/xfwgakrL
Sample of Supported Json Format
[
{
"version": "1.0",
"title": "Free IPTV",
"logo": "https://raw.githubusercontent.com/rogplay/public/refs/heads/main/assets/freeiptv.png",
"url": "https://raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8",
"type": "livetv",
"description": "List of Free and Public IPTV Channels available worldwide"
},
{
"version": "1.0",
"title": "Free Cinema",
"logo": "https://raw.githubusercontent.com/rogplay/public/refs/heads/main/assets/tmdb.jpg",
"url": "https://nl1.api.radio-browser.info/m3u/stations",
"type": "cinema",
"description": "List of Free and Public Cinema"
}
]
Currently 3 addons type cinema and livetv supported
"type": "cinema"
is read only can be used fr works only on cinema screen
"type": "livetv"
is used for displaying livetv or other streaming content on addons
"type": "movie"
is used for displaying movie based content "True API"
Streaming / LiveTV
Rogplay Support Native M3U and Json based structure for streaming contents
M3u Format
Below Sample M3u Example
#EXTM3U
#EXTINF:-1 tvg-id="1" tvg-logo="https://i.imgur.com/LMxTAzY.png" group-title="france",TF1 FHD
https://devstreaming-cdn.apple.com/videos/streaming/examples/img_bipbop_adv_example_fmp4/master.m3u8
#EXTINF:-1 tvg-id="2" tvg-logo="https://i.imgur.com/TmsIL5C.png" group-title="france",France 2
https://devstreaming-cdn.apple.com/videos/streaming/examples/img_bipbop_adv_example_fmp4/master.m3u8
HEADERS
You can pass headers in url by passing ? or & or |
in end of
url
Headers passed in url is case insensitive Origin, ORIGIN, orign treated same
You can pass multiple headers by using &
https://rogplay.live/index.m3u8?Referer=https://rogplay.live
https://rogplay.live/index.m3u8|User-Agent=https://rogplay.live
https://rogplay.live/index.m3u8?Referer=https://rogplay.live&Cookie=username=johndoe; expires=Thu, 18 Dec 2023
DRM Playback
Rogplay provides support for CLEARKEY, WIDEVINE, FLAIRPLAY, PLAYREADY drm scheme irrespective of your devices.
1. WIDEVINE
#EXTINF:-1, Demo channel
#KODIPROP:inputstream.adaptive.license_key=https://cwip-shaka-proxy.appspot.com/no_auth
#KODIPROP:inputstream.adaptive.license_type=WIDEVINE
https://cdn.bitmovin.com/content/assets/art-of-motion_drm/m3u8s/11331.m3u8
2. CLEARKEY
#EXTINF:-1, Demo channel
#KODIPROP:inputstream.adaptive.license_key=https://example.to/licenseurl
#KODIPROP:inputstream.adaptive.license_type=CLEARKEY
http://example.com/channel/02
Rogplay Supports differnt type of clearkeys format like base64 keys, hex keys as well as post request of license url
1. Clearkey Hex
#KODIPROP:inputstream.adaptive.license_key=edf1a715de9748638dd2fad75a419af2:2f5a3199b26e9b693ae881af7ff864cf
2. Base64 Encoded Json
{
"keys": [
{
"kty": "oct",
"k": "t+Aauiwwex8FBX6RqdFQ0g",
"kid": "4WQhz3w3TFeo9+kQSfWM2Q"
}
],
"type": "temporary"
}
3. Post license url returning base64 json/Hex
https://license.to/post
Json Format
Sample JSON Example
[
{
"Title": "Star Sports 1 HD",
"Poster": "https://i.postimg.cc/QM22x0Qj/Star-Sports-1-HD.png",
"Url": "https://madstream.one/hls/crichd/index.php?id=starhindi&e=.m3u8"
},
{
"Title": "Star Sports 1 Hindi HD",
"Poster": "https://i.postimg.cc/MZbCq0v8/Star-Sports-1-HD-Hindi.png",
"Url": "https://madstream.one/hls/crichd/index.php?id=starhindi&e=.m3u8"
}
]
Title [Mandatory]
Referers to name of stream
You can also use => name, filename, event_name, event {Case insensitive}
Poster [Mandatory]
Referers to name of poster of stream
You can also use => image, logo, src, {Case insensitive}
Url [Mandatory]
Referers to name of url of stream
You can also use => link, file, stream, {Case insensitive}
id [Mandatory]
Referers to id of stream
You can also use => link, file, stream, {Case insensitive}
headers [optional]
Referers to headers of stream
headers: {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3",
"Referer": "https://example.com",
"Cookie": "sessionid=1234567890abcdef",
}
Cinema
Rogplay uses TheMovieDB (TMDB) Api to display content on cinema screen, you can check Documentation here TMDB Documentation
Note: Cinema addons required to use make cinema functionable
Cinema Addons Example 👇
[
{
"version": "1.0",
"author": "HIGHRISK",
"title": "TMDB Cinema",
"logo": "https://raw.githubusercontent.com/rogplay/public/refs/heads/main/assets/tmdb.jpg",
"url": "https://raw.githubusercontent.com/kunwarxshashank/rogplay_addons/refs/heads/main/cinema/servers.json",
"type": "cinema",
"description": "Cinema Addons"
}
]
Title Logo Version and Auhtor will display in addons page.
Cinema Addons Url
This url contains actual cinema api which uses TMDB (themoviedb) ID, to fetch movies and series informations.
Cinema Json API Example 👇
[
{
"tvurl": "https://example.com/api/series?id=${tmdb}&season=${season}&episode=${episode}",
"movieurl": "https://example.com/api/movies?id=${tmdb}",
"title": "title",
"url": "file",
"id": "id"
}
]
1. tvurl
This url refers for series api which is used to fetch data from api url, must contains tmdb id season number and episode id, however you dont' need to pass tmdbid, season, and epsiode id in place of ${tmdb} ${season} ${episode} it acts as variable which fetch data from parameters
This is how tvurl https://example.com/api/series?id=${tmdb}&season=${season}&episode=${episode} response look like
[
{
"title": "Hindi",
"id": "d1fe1b17bd308b9c1cc9492def1b7661",
"file": "https://i-cdn-0.vino332gptk.com/stream2/i-cdn-0/301d9c67dd7860e62d9f925a8b944af1/MJTMsp1RshGTygnMNRUR2N2MSlnWXZEdMNDZzQWe5MDZzMmdZJTO1R2RWVHZDljekhkSsl1VwYnWtx2cihVT2lVba12TUxWbO1WS5llMRNjTUFVeOpWQ000VFFjWql0dOpXUz4ERSxWW6lVP:1738738855:82.180.147.152:68c79641163b24cb45b4b73d8da964224569f285925fcd8caf6f1117ce033a41/index.m3u8"
},
{
"title": "Tamil",
"id": "9962f8a48a95bf4da27960d01b5fb10c",
"file": "https://i-cdn-0.vino332gptk.com/stream2/i-cdn-0/301d9c67dd7860e62d9f925a8b944af1/MJTMsp1RshGTygnMNRUR2N2MSlnWXZEdMNDZzQWe5MDZzMmdZJTO1R2RWVHZDljekhkSsl1VwYnWtx2cihVT250RJd3TUNGMPdUVz8EVFdXTXJFaNpnRt1kaZpXW6lUNOJTV4pVbNdnTqVVP:1738738855:82.180.147.152:1b5a6f3e653dafd47c32b3c1580a5b7cbb0bd6637cf3daf0c4fc4fbba9d9f287/index.m3u8"
},
{
"title": "Telugu",
"id": "49e47e58e1cd2e9a683ab2ee0f3a0f2c",
"file": "https://i-cdn-0.vino332gptk.com/stream2/i-cdn-0/301d9c67dd7860e62d9f925a8b944af1/MJTMsp1RshGTygnMNRUR2N2MSlnWXZEdMNDZzQWe5MDZzMmdZJTO1R2RWVHZDljekhkSsl1VwYnWtx2cihVT290RNlXW6NWeOR0a3pFRatmTqVlMap2Z65kMWlmWEJkaPdlRo5keBFjTXlVP:1738738855:82.180.147.152:0335c5e302ea54d98ddcad1811f3e81f388af6459b282be42a37b85d63a76ca0/index.m3u8"
}
]
2. movie
This url refers for movie api which is used to fetch data from api url, must contains tmdb id, however you dont' need to pass tmdbid, in place of ${tmdb} it acts as variable which fetch data from parameters
3. title
This object points variable which uses to show title of content e.g. Sever - Hindi
4. url
This object points variable which indicate url of content e.g. https://example.m3u8i
5. id
This object points variable which indicate id of content e.g. 1, 2
6. headers
Referers to header of stream
headers: {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3",
"Referer": "https://example.com",
"Cookie": "sessionid=1234567890abcdef",
}
Movie
Movie are seamless feature of Rogplay, allow you create and play anything, unlike other type, they give full fledge access to streaming
Note: Cinema addons required to use make cinema functionable
Movie Addons Example 👇
[
{
"version": "1.0",
"author": "HIGHRISK",
"title": "Hindi Movie",
"logo": "https://yt3.googleusercontent.com/ytc/AIdro_maBL20YKBdGvd0wLHE-4plrMQ24c4GOys8J61jyx4A3Q=s900-c-k-c0x00ffffff-no-rj",
"url": "https://hindimovie.vercel.app",
"type": "movie",
"description": "Movies & Series Addon of https://111.90.159.132/ "
}
]
Title Logo Version and Auhtor will display in addons page.
Movie Addons Url
This is entrypoint of your api, all the parameters like search, page pass here
Searching a movie
https://hindimovie.vercel.app/?search=your_search
here param search is a search api, it uses this param in app to fetch content from api and displaying in app, your search result should look like this
pagination of movie list
https://hindimovie.vercel.app/?page=pagenum
here param page is used to retrive response when fetching larger contents
Response of search and pagination url
[
{
"url": "https://hindimovie.vercel.app/?url=https://111.90.159.132/action/titanic-2018/",
"title": "Titanic 2018",
"logo": "https://111.90.159.132/wp-content/uploads/2024/04/Titanic-2018-152x228.jpg"
},
{
"url": "https://hindimovie.vercel.app/?url=https://111.90.159.132/eps/titans-season-3-epi-6/",
"title": "Titans Season 3 Epi 6",
"logo": "https://111.90.159.132/wp-content/uploads/2023/04/6mi4lwYuKWBmy3Ie0Xp5YOd2dv8-152x228.jpg"
},
{
"url": "https://hindimovie.vercel.app/?url=https://111.90.159.132/fantasy/wrath-of-the-titans-082024/",
"title": "Wrath of the Titans 082024",
"logo": "https://111.90.159.132/wp-content/uploads/2024/01/b9n2R3xZWQ8MVZgndQoV34stS0h-152x228.jpg"
}
]
1. url
This url is a entrypoint of the stream url json, your stream json will appear on fetching it
Your url response should look like this
[
{
"title": "Hindi",
"id": "d1fe1b17bd308b9c1cc9492def1b7661",
"file": "https://i-cdn-0.vino332gptk.com/stream2/i-cdn-0/301d9c67dd7860e62d9f925a8b944af1/MJTMsp1RshGTygnMNRUR2N2MSlnWXZEdMNDZzQWe5MDZzMmdZJTO1R2RWVHZDljekhkSsl1VwYnWtx2cihVT2lVba12TUxWbO1WS5llMRNjTUFVeOpWQ000VFFjWql0dOpXUz4ERSxWW6lVP:1738738855:82.180.147.152:68c79641163b24cb45b4b73d8da964224569f285925fcd8caf6f1117ce033a41/index.m3u8"
"headers": {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3",
"Referer": "https://example.com",
"Cookie": "sessionid=1234567890abcdef"
}
},
{
"title": "Tamil",
"id": "9962f8a48a95bf4da27960d01b5fb10c",
"file": "https://i-cdn-0.vino332gptk.com/stream2/i-cdn-0/301d9c67dd7860e62d9f925a8b944af1/MJTMsp1RshGTygnMNRUR2N2MSlnWXZEdMNDZzQWe5MDZzMmdZJTO1R2RWVHZDljekhkSsl1VwYnWtx2cihVT250RJd3TUNGMPdUVz8EVFdXTXJFaNpnRt1kaZpXW6lUNOJTV4pVbNdnTqVVP:1738738855:82.180.147.152:1b5a6f3e653dafd47c32b3c1580a5b7cbb0bd6637cf3daf0c4fc4fbba9d9f287/index.m3u8"
},
{
"title": "Telugu",
"id": "49e47e58e1cd2e9a683ab2ee0f3a0f2c",
"file": "https://i-cdn-0.vino332gptk.com/stream2/i-cdn-0/301d9c67dd7860e62d9f925a8b944af1/MJTMsp1RshGTygnMNRUR2N2MSlnWXZEdMNDZzQWe5MDZzMmdZJTO1R2RWVHZDljekhkSsl1VwYnWtx2cihVT290RNlXW6NWeOR0a3pFRatmTqVlMap2Z65kMWlmWEJkaPdlRo5keBFjTXlVP:1738738855:82.180.147.152:0335c5e302ea54d98ddcad1811f3e81f388af6459b282be42a37b85d63a76ca0/index.m3u8"
}
]
1. id
Referers to title of stream
2. title
Referers to title of stream
3. file
Referers to url of stream
4. headers {optional}
Referers to headers