{ "type": "object", "description": "A list of live broadcast resources matching the request criteria.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#liveBroadcastListResponse.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "nextPageToken": { "type": "string", "description": "The token for the next page of results.", "example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9" }, "prevPageToken": { "type": "string", "description": "The token for the previous page of results.", "example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9" }, "pageInfo": { "type": "object", "description": "Paging details for a list of live streaming resources.", "properties": { "totalResults": { "type": "integer", "description": "The total number of results in the result set.", "example": 42 }, "resultsPerPage": { "type": "integer", "description": "The number of results included in the API response.", "example": 10 } } }, "items": { "type": "array", "description": "A list of live broadcasts that match the request criteria.", "example": [], "items": { "type": "object", "description": "A liveBroadcast resource represents an event that will be streamed, via live video, on YouTube.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#liveBroadcast.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "id": { "type": "string", "description": "The ID that YouTube assigns to uniquely identify the broadcast.", "example": "abc123def456" }, "snippet": { "type": "object", "description": "Basic details about a live broadcast including its title, description, and scheduled start and end times.", "properties": { "publishedAt": { "type": "string", "description": "The date and time that the broadcast was added to YouTube's live broadcast schedule.", "example": "2026-01-15T10:30:00Z", "format": "date-time" }, "channelId": { "type": "string", "description": "The ID of the channel to which this broadcast is affiliated.", "example": "500123" }, "title": { "type": "string", "description": "The broadcast's title. The title is a required field when inserting a broadcast.", "example": "Example Title" }, "description": { "type": "string", "description": "The broadcast's description.", "example": "A sample description for this resource." }, "thumbnails": { "type": "object", "description": "A map of thumbnail images associated with the broadcast.", "example": "example_value" }, "scheduledStartTime": { "type": "string", "description": "The date and time that the broadcast is scheduled to begin.", "example": "2026-01-15T10:30:00Z", "format": "date-time" }, "scheduledEndTime": { "type": "string", "description": "The date and time that the broadcast is scheduled to end.", "example": "2026-01-15T10:30:00Z", "format": "date-time" }, "actualStartTime": { "type": "string", "description": "The date and time that the broadcast actually started.", "example": "2026-01-15T10:30:00Z", "format": "date-time" }, "actualEndTime": { "type": "string", "description": "The date and time that the broadcast actually ended.", "example": "2026-01-15T10:30:00Z", "format": "date-time" }, "liveChatId": { "type": "string", "description": "The live chat ID associated with the broadcast.", "example": "500123" }, "isDefaultBroadcast": { "type": "boolean", "description": "Indicates whether this broadcast is the default broadcast.", "example": true } } }, "status": { "type": "object", "description": "Status information about a live broadcast including its privacy status and lifecycle status.", "properties": { "lifeCycleStatus": { "type": "string", "description": "The broadcast's status as it relates to the lifecycle of the broadcast.", "example": "abandoned", "enum": [ "abandoned", "complete", "completeStarting", "created", "live", "liveStarting", "ready", "reclaimed", "revoked", "testStarting", "testing" ] }, "privacyStatus": { "type": "string", "description": "The broadcast's privacy status.", "example": "private", "enum": [ "private", "public", "unlisted" ] }, "recordingStatus": { "type": "string", "description": "The broadcast's recording status.", "example": "notRecording", "enum": [ "notRecording", "recorded", "recording" ] }, "madeForKids": { "type": "boolean", "description": "Indicates whether the broadcast is designated as child-directed.", "example": "channel==UC_x5XG1OV2P6uZZ5FSM9Ttw" }, "selfDeclaredMadeForKids": { "type": "boolean", "description": "Indicates whether the channel owner has designated the broadcast as being made for kids.", "example": "channel==UC_x5XG1OV2P6uZZ5FSM9Ttw" } } }, "contentDetails": { "type": "object", "description": "Detailed settings for a live broadcast including stream configuration, DVR settings, and content configuration.", "properties": { "boundStreamId": { "type": "string", "description": "The ID of the stream that is bound to the broadcast.", "example": "500123" }, "boundStreamLastUpdateTimeMs": { "type": "string", "description": "The date and time that the live stream referenced by boundStreamId was last updated.", "example": "example_value" }, "monitorStream": { "type": "object", "description": "The monitorStream object contains information about the monitor stream, which the broadcaster can use to review the event content before the broadcast stream is shown publicly.", "example": "example_value", "properties": { "enableMonitorStream": { "type": "boolean", "description": "This value determines whether the monitor stream is enabled for the broadcast." }, "broadcastStreamDelayMs": { "type": "integer", "description": "If you have set the enableMonitorStream property to true, this value sets the delay between the video input and the broadcast monitor stream." }, "embedHtml": { "type": "string", "description": "The HTML code that embeds a player that plays the monitor stream." } } }, "enableEmbed": { "type": "boolean", "description": "Indicates whether the broadcast video can be played in an embedded player.", "example": true }, "enableDvr": { "type": "boolean", "description": "Indicates whether the broadcast enables DVR controls. DVR controls enable the viewer to control the video playback experience by pausing, rewinding, or fast forwarding portions of the broadcast.", "example": true }, "enableContentEncryption": { "type": "boolean", "description": "Indicates whether YouTube should enable content encryption for the broadcast.", "example": true }, "startWithSlate": { "type": "boolean", "description": "Indicates whether the broadcast should automatically begin with an in-stream slate when you update the broadcast's status to live.", "example": true }, "closedCaptionsType": { "type": "string", "description": "Indicates whether the broadcast has captions enabled.", "example": "closedCaptionsDisabled", "enum": [ "closedCaptionsDisabled", "closedCaptionsEmbedded", "closedCaptionsHttpPost" ] }, "enableLowLatency": { "type": "boolean", "description": "Indicates whether this broadcast has low latency enabled.", "example": true }, "latencyPreference": { "type": "string", "description": "Indicates latency preference for the broadcast. The options are ultraLow, low, and normal.", "example": "low", "enum": [ "low", "normal", "ultraLow" ] }, "enableAutoStart": { "type": "boolean", "description": "This setting indicates whether the broadcast should automatically begin streaming.", "example": true }, "enableAutoStop": { "type": "boolean", "description": "Indicates whether the broadcast should automatically stop streaming.", "example": true } } }, "statistics": { "type": "object", "description": "The statistics object contains info about the live broadcast.", "example": "example_value", "properties": { "totalChatCount": { "type": "integer", "description": "The number of live chat messages currently on the broadcast.", "format": "int64" } } } }, "required": [ "kind", "etag" ] } } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "LiveBroadcastListResponse", "x-schema-source": "openapi", "x-source-url": "openapi/youtube-live-streaming-openapi.yml" }