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.
View JSON Schema on GitHub

JSON Schema

youtube-live-live-stream-list-response-schema.json Raw ↑
{
  "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"
}