Series Streams & VODs
Fetch live/watch-party streams and VOD/video links for a match - Twitch, YouTube, Kick, regional platforms, and per-map videos.
series.vods(series_id) returns the streams and VOD (Video on Demand) links shown on a match page. Live broadcasts and watch parties are available even for upcoming matches; full-match and per-map videos are available after the match.
Signature
series.vods(series_id: int) -> SeriesVodsWith curried access:
vlrdevapi.series(series_id).vods() -> SeriesVodsParameters
Prop
Type
Returns - SeriesVods
Prop
Type
SeriesStream Fields
Prop
Type
SeriesVod Fields
Prop
Type
Examples
List official streams and watch parties
Filter by stream_type to show only official broadcasts or include co-streams.
import vlrdevapi
media = vlrdevapi.series.vods(series_id=754737)
for stream in media.streams:
if stream.stream_type == "broadcast":
print(f"[{stream.platform}] {stream.channel}: {stream.url}")Filter by platform and country
country_code is useful when a match has regional broadcasts on many platforms.
import vlrdevapi
media = vlrdevapi.series.vods(series_id=777944)
for stream in media.streams:
if stream.country_code == "cn":
print(f"{stream.platform}: {stream.channel} ({stream.url})")List all VODs
Each VOD entry has a label, platform, and optional map number and start offset.
import vlrdevapi
media = vlrdevapi.series.vods(series_id=542272)
for vod in media.vods:
map_label = f"Map {vod.map_number}" if vod.map_number else "Full match"
print(f"{map_label}: {vod.label} [{vod.platform}] {vod.url}")Split full-match and per-map VODs
import vlrdevapi
media = vlrdevapi.series.vods(series_id=542272)
full_match = [vod for vod in media.vods if vod.map_number is None]
map_vods = [vod for vod in media.vods if vod.map_number is not None]
print(f"Full match: {full_match[0].url if full_match else 'not available'}")
for vod in map_vods:
print(f"Map {vod.map_number} ({vod.label}): {vod.url}")Curried access
Use the curried pattern to access streams and VODs without passing the series ID repeatedly.
import vlrdevapi
series = vlrdevapi.series(754737)
media = series.vods()
print(f"{len(media.streams)} streams, {len(media.vods)} VODs")
for stream in media.streams:
print(f"[{stream.stream_type}] {stream.channel} - {stream.url}")Last updated on