Youtube · Schema
LiveStreamListResponse
A list of live stream resources matching the request criteria.
GoogleMediaSocialStreamingVideoVideos
Properties
| Name | Type | Description |
|---|---|---|
| kind | string | Identifies the API resource's type. Value is youtube#liveStreamListResponse. |
| etag | string | The Etag of this resource. |
| nextPageToken | string | The token for the next page of results. |
| prevPageToken | string | The token for the previous page of results. |
| pageInfo | object | Paging details for a list of live streaming resources. |
| items | array | A list of live streams that match the request criteria. |
JSON Schema
{
"type": "object",
"description": "A list of live stream resources matching the request criteria.",
"properties": {
"kind": {
"type": "string",
"description": "Identifies the API resource's type. Value is youtube#liveStreamListResponse.",
"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 streams that match the request criteria.",
"example": [],
"items": {
"type": "object",
"description": "A liveStream resource contains information about the video stream that you are transmitting to YouTube. The stream provides the content that will be broadcast to YouTube users.",
"properties": {
"kind": {
"type": "string",
"description": "Identifies the API resource's type. Value is youtube#liveStream.",
"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 stream.",
"example": "abc123def456"
},
"snippet": {
"type": "object",
"description": "Basic details about a live stream including its title, description, and channel association.",
"properties": {
"channelId": {
"type": "string",
"description": "The ID of the channel to which this stream is affiliated.",
"example": "500123"
},
"title": {
"type": "string",
"description": "The stream's title. The value must be between 1 and 128 characters long.",
"example": "Example Title"
},
"description": {
"type": "string",
"description": "The stream's description. The value cannot be longer than 10000 characters.",
"example": "A sample description for this resource."
},
"publishedAt": {
"type": "string",
"description": "The date and time that the stream was created.",
"example": "2026-01-15T10:30:00Z",
"format": "date-time"
},
"isDefaultStream": {
"type": "boolean",
"description": "Indicates whether this stream is the default stream.",
"example": true
}
}
},
"cdn": {
"type": "object",
"description": "The cdn object defines the live stream's content delivery network (CDN) settings.",
"example": "example_value",
"properties": {
"ingestionType": {
"type": "string",
"description": "The method or protocol used to transmit the video stream.",
"enum": [
"dash",
"rtmp",
"webrtc"
]
},
"ingestionInfo": {
"type": "object",
"description": "The ingestionInfo object contains information that YouTube provides that you need to transmit your RTMP or HTTP stream to YouTube.",
"properties": {
"streamName": {
"type": "string",
"description": "The stream name that YouTube assigns to the video stream."
},
"ingestionAddress": {
"type": "string",
"description": "The primary ingestion URL that you should use to stream video to YouTube."
},
"backupIngestionAddress": {
"type": "string",
"description": "The backup ingestion URL that you should use to stream video to YouTube."
},
"rtmpsIngestionAddress": {
"type": "string",
"description": "The primary secured ingestion URL that you should use to stream video to YouTube."
},
"backupRtmpsIngestionAddress": {
"type": "string",
"description": "The backup secured ingestion URL that you should use to stream video to YouTube."
}
}
},
"resolution": {
"type": "string",
"description": "The resolution of the inbound video data."
},
"frameRate": {
"type": "string",
"description": "The frame rate of the inbound video data."
}
}
},
"status": {
"type": "object",
"description": "Status information about a live stream including its stream status and health status.",
"properties": {
"streamStatus": {
"type": "string",
"description": "The stream's current status.",
"example": "active",
"enum": [
"active",
"created",
"error",
"inactive",
"ready"
]
},
"healthStatus": {
"type": "object",
"description": "The health status of the stream.",
"example": "example_value",
"properties": {
"status": {
"type": "string",
"description": "The status code of this stream.",
"enum": [
"bad",
"good",
"noData",
"ok",
"revoked"
]
},
"lastUpdateTimeSeconds": {
"type": "integer",
"description": "The last time this status was updated, as a Unix timestamp.",
"format": "int64"
},
"configurationIssues": {
"type": "array",
"description": "The configurations issues on this stream.",
"items": {
"type": "object"
}
}
}
}
}
},
"contentDetails": {
"type": "object",
"description": "Detailed settings for a live stream including the stream key and ingestion settings.",
"properties": {
"boundBroadcastId": {
"type": "string",
"description": "The ID of the live broadcast to which this stream is bound.",
"example": "500123"
},
"isReusable": {
"type": "boolean",
"description": "Indicates whether the stream is reusable, which means that it can be bound to multiple broadcasts.",
"example": true
}
}
}
},
"required": [
"kind",
"etag"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "LiveStreamListResponse",
"x-schema-source": "openapi",
"x-source-url": "openapi/youtube-live-streaming-openapi.yml"
}