Youtube LiveBroadcasts API

Operations for managing YouTube live broadcast events

Operations 6

GET /liveBroadcasts Youtube List Live Broadcasts #
POST /liveBroadcasts Youtube Create a Live Broadcast #
PUT /liveBroadcasts Youtube Update a Live Broadcast #
DELETE /liveBroadcasts Youtube Delete a Live Broadcast #
POST /liveBroadcasts/bind Youtube Bind Broadcast to Stream #
POST /liveBroadcasts/transition Youtube Transition Broadcast State #

Documentation

📖
Documentation
https://developers.google.com/youtube/v3/docs/activities/list
📖
GettingStarted
https://developers.google.com/youtube/v3/getting-started
📖
Authentication
https://developers.google.com/youtube/v3/guides/authentication
📖
Documentation
https://developers.google.com/youtube/v3/docs/channels/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/comments/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/commentThreads/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/playlists/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/playlistItems/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/search/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/subscriptions/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/videos/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/captions
📖
Documentation
https://developers.google.com/youtube/v3/docs/videoCategories
📖
Documentation
https://developers.google.com/youtube/v3/docs/i18nLanguages
📖
Documentation
https://developers.google.com/youtube/v3/docs/i18nRegions
📖
Documentation
https://developers.google.com/youtube/analytics
📖
GettingStarted
https://developers.google.com/youtube/reporting/guides/authorization
📖
APIReference
https://developers.google.com/youtube/analytics/reference
📖
Authentication
https://developers.google.com/youtube/reporting/guides/authorization
📖
Documentation
https://developers.google.com/youtube/reporting
📖
APIReference
https://developers.google.com/youtube/reporting/v1/reference/rest
📖
Documentation
https://developers.google.com/youtube/reporting/v1/reports
📖
GettingStarted
https://developers.google.com/youtube/v3/live/getting-started
📖
Documentation
https://developers.google.com/youtube/v3/live/docs
📖
APIReference
https://developers.google.com/youtube/v3/live/docs

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/youtube-livebroadcasts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

youtube-livebroadcasts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: YouTube Live Streaming Live Broadcasts API
  description: The YouTube Live Streaming API lets you create, update, and manage live video broadcasts and live video streams on YouTube. The API provides resources for liveBroadcasts, liveStreams, liveChatMessages, liveChatModerators, liveChatBans, and superChatEvents. Broadcasts are scheduled events that viewers can watch live, while streams are the actual video feed bound to a broadcast.
  version: v3
  contact:
    name: YouTube API Support
    url: https://developers.google.com/youtube/v3/live/support
  termsOfService: https://developers.google.com/youtube/terms/api-services-terms-of-service
servers:
- url: https://www.googleapis.com/youtube/v3
  description: YouTube Live Streaming API base server (shared with YouTube Data API v3)
security:
- oauth2:
  - https://www.googleapis.com/auth/youtube
tags:
- name: LiveBroadcasts
  description: Operations for managing YouTube live broadcast events
paths:
  /liveBroadcasts:
    get:
      operationId: youtube.liveBroadcasts.list
      summary: Youtube List Live Broadcasts
      description: Returns a list of YouTube broadcasts that match the API request parameters. You can retrieve broadcasts for the authenticated user or retrieve specific broadcasts by their IDs.
      tags:
      - LiveBroadcasts
      parameters:
      - $ref: '#/components/parameters/part'
      - name: id
        in: query
        description: Comma-separated list of YouTube broadcast IDs for the resources being retrieved.
        schema:
          type: string
        example: abc123def456
      - name: mine
        in: query
        description: Set this parameter to true to instruct the API to return only broadcasts owned by the authenticated user.
        schema:
          type: boolean
        example: true
      - name: broadcastStatus
        in: query
        description: Filters the API response to only include broadcasts with the specified status.
        schema:
          type: string
          enum:
          - active
          - all
          - completed
          - upcoming
        example: active
      - name: broadcastType
        in: query
        description: Filters results by the type of broadcast. Acceptable values are event and persistent.
        schema:
          type: string
          enum:
          - all
          - event
          - persistent
        example: all
      - $ref: '#/components/parameters/maxResults'
      - $ref: '#/components/parameters/pageToken'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/key'
      responses:
        '200':
          description: Successful response containing a list of live broadcast resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveBroadcastListResponse'
              examples:
                YoutubeLivebroadcastsList200Example:
                  summary: Default youtube.liveBroadcasts.list 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    nextPageToken: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
                    prevPageToken: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
                    pageInfo:
                      totalResults: 42
                      resultsPerPage: 10
                    items:
                    - kind: youtube#video
                      etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                      id: abc123def456
                      statistics:
                        totalChatCount: 42
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: youtube.liveBroadcasts.insert
      summary: Youtube Create a Live Broadcast
      description: Creates a broadcast. The authenticated user must be authorized to create broadcasts. After creating the broadcast, you will need to bind it to a stream and set it live.
      tags:
      - LiveBroadcasts
      parameters:
      - $ref: '#/components/parameters/part'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/key'
      requestBody:
        description: The live broadcast resource to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiveBroadcast'
            examples:
              YoutubeLivebroadcastsInsertRequestExample:
                summary: Default youtube.liveBroadcasts.insert request
                x-microcks-default: true
                value:
                  kind: youtube#video
                  etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                  id: abc123def456
                  snippet:
                    publishedAt: '2026-01-15T10:30:00Z'
                    channelId: '500123'
                    title: Example Title
                    description: A sample description for this resource.
                    thumbnails: example_value
                    scheduledStartTime: '2026-01-15T10:30:00Z'
                    scheduledEndTime: '2026-01-15T10:30:00Z'
                    actualStartTime: '2026-01-15T10:30:00Z'
                    actualEndTime: '2026-01-15T10:30:00Z'
                    liveChatId: '500123'
                    isDefaultBroadcast: true
                  status:
                    lifeCycleStatus: abandoned
                    privacyStatus: private
                    recordingStatus: notRecording
                    madeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                    selfDeclaredMadeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                  contentDetails:
                    boundStreamId: '500123'
                    boundStreamLastUpdateTimeMs: example_value
                    monitorStream:
                      enableMonitorStream: true
                      broadcastStreamDelayMs: 10
                      embedHtml: example_value
                    enableEmbed: true
                    enableDvr: true
                    enableContentEncryption: true
                    startWithSlate: true
                    closedCaptionsType: closedCaptionsDisabled
                    enableLowLatency: true
                    latencyPreference: low
                    enableAutoStart: true
                    enableAutoStop: true
                  statistics:
                    totalChatCount: 42
      responses:
        '200':
          description: Successful response containing the newly created live broadcast resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveBroadcast'
              examples:
                YoutubeLivebroadcastsInsert200Example:
                  summary: Default youtube.liveBroadcasts.insert 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    id: abc123def456
                    snippet:
                      publishedAt: '2026-01-15T10:30:00Z'
                      channelId: '500123'
                      title: Example Title
                      description: A sample description for this resource.
                      thumbnails: example_value
                      scheduledStartTime: '2026-01-15T10:30:00Z'
                      scheduledEndTime: '2026-01-15T10:30:00Z'
                      actualStartTime: '2026-01-15T10:30:00Z'
                      actualEndTime: '2026-01-15T10:30:00Z'
                      liveChatId: '500123'
                      isDefaultBroadcast: true
                    status:
                      lifeCycleStatus: abandoned
                      privacyStatus: private
                      recordingStatus: notRecording
                      madeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                      selfDeclaredMadeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                    contentDetails:
                      boundStreamId: '500123'
                      boundStreamLastUpdateTimeMs: example_value
                      monitorStream:
                        enableMonitorStream: true
                        broadcastStreamDelayMs: 10
                        embedHtml: example_value
                      enableEmbed: true
                      enableDvr: true
                      enableContentEncryption: true
                      startWithSlate: true
                      closedCaptionsType: closedCaptionsDisabled
                      enableLowLatency: true
                      latencyPreference: low
                      enableAutoStart: true
                      enableAutoStop: true
                    statistics:
                      totalChatCount: 42
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: youtube.liveBroadcasts.update
      summary: Youtube Update a Live Broadcast
      description: Updates a broadcast's settings. The authenticated user must own the broadcast being updated. Note that certain properties cannot be modified after a broadcast goes live.
      tags:
      - LiveBroadcasts
      parameters:
      - $ref: '#/components/parameters/part'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/key'
      requestBody:
        description: The live broadcast resource with updated properties.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiveBroadcast'
            examples:
              YoutubeLivebroadcastsUpdateRequestExample:
                summary: Default youtube.liveBroadcasts.update request
                x-microcks-default: true
                value:
                  kind: youtube#video
                  etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                  id: abc123def456
                  snippet:
                    publishedAt: '2026-01-15T10:30:00Z'
                    channelId: '500123'
                    title: Example Title
                    description: A sample description for this resource.
                    thumbnails: example_value
                    scheduledStartTime: '2026-01-15T10:30:00Z'
                    scheduledEndTime: '2026-01-15T10:30:00Z'
                    actualStartTime: '2026-01-15T10:30:00Z'
                    actualEndTime: '2026-01-15T10:30:00Z'
                    liveChatId: '500123'
                    isDefaultBroadcast: true
                  status:
                    lifeCycleStatus: abandoned
                    privacyStatus: private
                    recordingStatus: notRecording
                    madeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                    selfDeclaredMadeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                  contentDetails:
                    boundStreamId: '500123'
                    boundStreamLastUpdateTimeMs: example_value
                    monitorStream:
                      enableMonitorStream: true
                      broadcastStreamDelayMs: 10
                      embedHtml: example_value
                    enableEmbed: true
                    enableDvr: true
                    enableContentEncryption: true
                    startWithSlate: true
                    closedCaptionsType: closedCaptionsDisabled
                    enableLowLatency: true
                    latencyPreference: low
                    enableAutoStart: true
                    enableAutoStop: true
                  statistics:
                    totalChatCount: 42
      responses:
        '200':
          description: Successful response containing the updated live broadcast resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveBroadcast'
              examples:
                YoutubeLivebroadcastsUpdate200Example:
                  summary: Default youtube.liveBroadcasts.update 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    id: abc123def456
                    snippet:
                      publishedAt: '2026-01-15T10:30:00Z'
                      channelId: '500123'
                      title: Example Title
                      description: A sample description for this resource.
                      thumbnails: example_value
                      scheduledStartTime: '2026-01-15T10:30:00Z'
                      scheduledEndTime: '2026-01-15T10:30:00Z'
                      actualStartTime: '2026-01-15T10:30:00Z'
                      actualEndTime: '2026-01-15T10:30:00Z'
                      liveChatId: '500123'
                      isDefaultBroadcast: true
                    status:
                      lifeCycleStatus: abandoned
                      privacyStatus: private
                      recordingStatus: notRecording
                      madeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                      selfDeclaredMadeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                    contentDetails:
                      boundStreamId: '500123'
                      boundStreamLastUpdateTimeMs: example_value
                      monitorStream:
                        enableMonitorStream: true
                        broadcastStreamDelayMs: 10
                        embedHtml: example_value
                      enableEmbed: true
                      enableDvr: true
                      enableContentEncryption: true
                      startWithSlate: true
                      closedCaptionsType: closedCaptionsDisabled
                      enableLowLatency: true
                      latencyPreference: low
                      enableAutoStart: true
                      enableAutoStop: true
                    statistics:
                      totalChatCount: 42
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: youtube.liveBroadcasts.delete
      summary: Youtube Delete a Live Broadcast
      description: Deletes a broadcast. The authenticated user must own the broadcast being deleted. Broadcasts cannot be deleted while they are in the live or testing status.
      tags:
      - LiveBroadcasts
      parameters:
      - name: id
        in: query
        required: true
        description: The ID of the broadcast to delete.
        schema:
          type: string
        example: abc123def456
      - $ref: '#/components/parameters/key'
      responses:
        '204':
          description: The broadcast was successfully deleted.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /liveBroadcasts/bind:
    post:
      operationId: youtube.liveBroadcasts.bind
      summary: Youtube Bind Broadcast to Stream
      description: Binds a YouTube broadcast to a stream or removes an existing binding between a broadcast and a stream. A broadcast can only be bound to one video stream, though a video stream may be bound to more than one broadcast.
      tags:
      - LiveBroadcasts
      parameters:
      - name: id
        in: query
        required: true
        description: The id parameter specifies the unique ID of the broadcast that is being bound to a video stream.
        schema:
          type: string
        example: abc123def456
      - $ref: '#/components/parameters/part'
      - name: streamId
        in: query
        description: The streamId parameter specifies the unique ID of the video stream that is being bound to a broadcast. If this parameter is omitted, the API will remove any existing binding between the broadcast and a video stream.
        schema:
          type: string
        example: '500123'
      - $ref: '#/components/parameters/key'
      responses:
        '200':
          description: Successful response containing the updated live broadcast resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveBroadcast'
              examples:
                YoutubeLivebroadcastsBind200Example:
                  summary: Default youtube.liveBroadcasts.bind 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    id: abc123def456
                    snippet:
                      publishedAt: '2026-01-15T10:30:00Z'
                      channelId: '500123'
                      title: Example Title
                      description: A sample description for this resource.
                      thumbnails: example_value
                      scheduledStartTime: '2026-01-15T10:30:00Z'
                      scheduledEndTime: '2026-01-15T10:30:00Z'
                      actualStartTime: '2026-01-15T10:30:00Z'
                      actualEndTime: '2026-01-15T10:30:00Z'
                      liveChatId: '500123'
                      isDefaultBroadcast: true
                    status:
                      lifeCycleStatus: abandoned
                      privacyStatus: private
                      recordingStatus: notRecording
                      madeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                      selfDeclaredMadeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                    contentDetails:
                      boundStreamId: '500123'
                      boundStreamLastUpdateTimeMs: example_value
                      monitorStream:
                        enableMonitorStream: true
                        broadcastStreamDelayMs: 10
                        embedHtml: example_value
                      enableEmbed: true
                      enableDvr: true
                      enableContentEncryption: true
                      startWithSlate: true
                      closedCaptionsType: closedCaptionsDisabled
                      enableLowLatency: true
                      latencyPreference: low
                      enableAutoStart: true
                      enableAutoStop: true
                    statistics:
                      totalChatCount: 42
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /liveBroadcasts/transition:
    post:
      operationId: youtube.liveBroadcasts.transition
      summary: Youtube Transition Broadcast State
      description: 'Changes the status of a YouTube live broadcast and initiates any processes associated with the new status. Valid transitions are: ready -> testing, testing -> live, live -> complete, ready -> live (skips testing state).'
      tags:
      - LiveBroadcasts
      parameters:
      - name: id
        in: query
        required: true
        description: The id parameter specifies the unique ID of the broadcast that is transitioning to another status.
        schema:
          type: string
        example: abc123def456
      - name: broadcastStatus
        in: query
        required: true
        description: The broadcastStatus parameter identifies the state to which the broadcast is changing.
        schema:
          type: string
          enum:
          - complete
          - live
          - testing
        example: complete
      - $ref: '#/components/parameters/part'
      - $ref: '#/components/parameters/key'
      responses:
        '200':
          description: Successful response containing the updated live broadcast resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveBroadcast'
              examples:
                YoutubeLivebroadcastsTransition200Example:
                  summary: Default youtube.liveBroadcasts.transition 200 response
                  x-microcks-default: true
                  value:
                    kind: youtube#video
                    etag: XI7nbFXulYBIpL0ayR_gDh3eu1k
                    id: abc123def456
                    snippet:
                      publishedAt: '2026-01-15T10:30:00Z'
                      channelId: '500123'
                      title: Example Title
                      description: A sample description for this resource.
                      thumbnails: example_value
                      scheduledStartTime: '2026-01-15T10:30:00Z'
                      scheduledEndTime: '2026-01-15T10:30:00Z'
                      actualStartTime: '2026-01-15T10:30:00Z'
                      actualEndTime: '2026-01-15T10:30:00Z'
                      liveChatId: '500123'
                      isDefaultBroadcast: true
                    status:
                      lifeCycleStatus: abandoned
                      privacyStatus: private
                      recordingStatus: notRecording
                      madeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                      selfDeclaredMadeForKids: channel==UC_x5XG1OV2P6uZZ5FSM9Ttw
                    contentDetails:
                      boundStreamId: '500123'
                      boundStreamLastUpdateTimeMs: example_value
                      monitorStream:
                        enableMonitorStream: true
                        broadcastStreamDelayMs: 10
                        embedHtml: example_value
                      enableEmbed: true
                      enableDvr: true
                      enableContentEncryption: true
                      startWithSlate: true
                      closedCaptionsType: closedCaptionsDisabled
                      enableLowLatency: true
                      latencyPreference: low
                      enableAutoStart: true
                      enableAutoStop: true
                    statistics:
                      totalChatCount: 42
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    LiveBroadcastContentDetails:
      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.
          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.
          example: example_value
        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.
          enum:
          - closedCaptionsDisabled
          - closedCaptionsEmbedded
          - closedCaptionsHttpPost
          example: closedCaptionsDisabled
        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.
          enum:
          - low
          - normal
          - ultraLow
          example: low
        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
    ErrorResponse:
      type: object
      description: A standard error response returned by the YouTube Live Streaming API.
      properties:
        error:
          type: object
          description: The error details.
          properties:
            code:
              type: integer
              description: The HTTP status code of the error.
            message:
              type: string
              description: A human-readable description of the error.
            errors:
              type: array
              description: A list of individual errors.
              items:
                type: object
                properties:
                  message:
                    type: string
                    description: A human-readable description of the error.
                  domain:
                    type: string
                    description: The domain in which the error occurred.
                  reason:
                    type: string
                    description: The reason for the error.
          example: example_value
    LiveBroadcastListResponse:
      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.
          default: 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:
          $ref: '#/components/schemas/PageInfo'
        items:
          type: array
          description: A list of live broadcasts that match the request criteria.
          items:
            $ref: '#/components/schemas/LiveBroadcast'
          example: []
    LiveBroadcastStatus:
      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.
          enum:
          - abandoned
          - complete
          - completeStarting
          - created
          - live
          - liveStarting
          - ready
          - reclaimed
          - revoked
          - testStarting
          - testing
          example: abandoned
        privacyStatus:
          type: string
          description: The broadcast's privacy status.
          enum:
          - private
          - public
          - unlisted
          example: private
        recordingStatus:
          type: string
          description: The broadcast's recording status.
          enum:
          - notRecording
          - recorded
          - recording
          example: notRecording
        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
    LiveBroadcastSnippet:
      type: object
      description: Basic details about a live broadcast including its title, description, and scheduled start and end times.
      properties:
        publishedAt:
          type: string
          format: date-time
          description: The date and time that the broadcast was added to YouTube's live broadcast schedule.
          example: '2026-01-15T10:30:00Z'
        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.
          additionalProperties:
            type: object
            properties:
              url:
                type: string
                description: The URL of the thumbnail image.
              width:
                type: integer
                description: The thumbnail width in pixels.
              height:
                type: integer
                description: The thumbnail height in pixels.
          example: example_value
        scheduledStartTime:
          type: string
          format: date-time
          description: The date and time that the broadcast is scheduled to begin.
          example: '2026-01-15T10:30:00Z'
        scheduledEndTime:
          type: string
          format: date-time
          description: The date and time that the broadcast is scheduled to end.
          example: '2026-01-15T10:30:00Z'
        actualStartTime:
          type: string
          format: date-time
          description: The date and time that the broadcast actually started.
          example: '2026-01-15T10:30:00Z'
        actualEndTime:
          type: string
          format: date-time
          description: The date and time that the broadcast actually ended.
          example: '2026-01-15T10:30:00Z'
        liveChatId:
          type: string
          description: The live chat ID associated with the broadcast.
          example: '500123'
        isDefaultBroadcast:
          type: boolean
        

# --- truncated at 32 KB (36 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/youtube/refs/heads/main/openapi/youtube-livebroadcasts-api-openapi.yml