Skip to main content
GET
GetYoutubeLiveStreamInfo

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

channel
string

Deprecated: YouTube channel handle or ID. Channel live detection is retired; a channel-only query returns error "channel_live_detection_retired".

video_id
string

YouTube video ID to name.

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

GetYoutubeLiveStreamInfoResponse containing the oEmbed lookup result.

videoId
string

Video ID that was looked up.

isLive
boolean
deprecated

Always false: oEmbed does not report whether a video is live.

channelExists
boolean
deprecated

Deprecated: true only when the oEmbed lookup succeeded, so it now carries exactly error == "".

channelName
string

Human-readable channel name.

hlsUrl
string
deprecated

Always empty: YouTube manifest URLs are no longer returned.

title
string

Video title.

error
string

"channel_live_detection_retired" for a channel-only query, or why the video lookup failed.