Youtube · Schema

VideoSnippet

Basic details about a video, including its title, description, tags, and category.

GoogleMediaSocialStreamingVideoVideos

Properties

Name	Type	Description
publishedAt	string	The date and time when the video was published.
channelId	string	The ID of the YouTube channel that published the video.
title	string	The video title.
description	string	The video description.
thumbnails	object	A map of thumbnail images associated with the video.
channelTitle	string	The channel title of the YouTube channel that published the video.
tags	array	A list of keyword tags associated with the video.
categoryId	string	The YouTube video category associated with the video.
liveBroadcastContent	string	Indicates if the video is an upcoming/active live broadcast.
defaultLanguage	string	The language of the text in the video resource's snippet.title and snippet.description properties.
localized	object	The snippet.localized object contains either a localized title and description for the video or the title in the default language.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/VideoSnippet",
  "title": "VideoSnippet",
  "type": "object",
  "description": "Basic details about a video, including its title, description, tags, and category.",
  "properties": {
    "publishedAt": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time when the video was published.",
      "example": "2026-01-15T10:30:00Z"
    },
    "channelId": {
      "type": "string",
      "description": "The ID of the YouTube channel that published the video.",
      "example": "500123"
    },
    "title": {
      "type": "string",
      "description": "The video title.",
      "example": "Example Title"
    },
    "description": {
      "type": "string",
      "description": "The video description.",
      "example": "A sample description for this resource."
    },
    "thumbnails": {
      "type": "object",
      "description": "A map of thumbnail images associated with the video.",
      "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"
    },
    "channelTitle": {
      "type": "string",
      "description": "The channel title of the YouTube channel that published the video.",
      "example": "example_value"
    },
    "tags": {
      "type": "array",
      "description": "A list of keyword tags associated with the video.",
      "items": {
        "type": "string"
      },
      "example": []
    },
    "categoryId": {
      "type": "string",
      "description": "The YouTube video category associated with the video.",
      "example": "500123"
    },
    "liveBroadcastContent": {
      "type": "string",
      "description": "Indicates if the video is an upcoming/active live broadcast.",
      "enum": [
        "live",
        "none",
        "upcoming"
      ],
      "example": "live"
    },
    "defaultLanguage": {
      "type": "string",
      "description": "The language of the text in the video resource's snippet.title and snippet.description properties.",
      "example": "en"
    },
    "localized": {
      "type": "object",
      "description": "The snippet.localized object contains either a localized title and description for the video or the title in the default language.",
      "properties": {
        "title": {
          "type": "string",
          "description": "The localized video title."
        },
        "description": {
          "type": "string",
          "description": "The localized video description."
        }
      },
      "example": "example_value"
    }
  }
}