{
 "collection_methods": {
  "collect_by_url": {
   "input_schema": [
    {
     "name": "url",
     "required": true,
     "type": "url"
    },
    {
     "name": "discovery_input",
     "required": false,
     "type": "object"
    },
    {
     "name": "subscribers",
     "required": false,
     "type": "number"
    },
    {
     "name": "country",
     "required": false,
     "type": "text"
    },
    {
     "name": "transcription_language",
     "required": false,
     "type": "text"
    }
   ],
   "output_fields": [
    {
     "description": "The full YouTube watch URL of the collected video",
     "name": "url",
     "type": "url"
    },
    {
     "description": "Title of the YouTube video",
     "name": "title",
     "type": "text"
    },
    {
     "description": "The channel handle extracted from the channel's browse endpoint",
     "name": "youtuber",
     "type": "text"
    },
    {
     "description": "MD5 hash of the youtuber field",
     "name": "youtuber_md5",
     "type": "text"
    },
    {
     "description": "Direct streaming URL of the video file, extracted from YouTube's adaptive formats or decoded from signatureCipher",
     "name": "video_url",
     "type": "url"
    },
    {
     "description": "Duration of the video in seconds",
     "name": "video_length",
     "type": "number"
    },
    {
     "description": "Number of likes received by the video",
     "name": "likes",
     "type": "number"
    },
    {
     "description": "Number of views the video has received",
     "name": "views",
     "type": "number"
    },
    {
     "description": "Date when the video was published",
     "name": "date_posted",
     "type": "date"
    },
    {
     "description": "Text description accompanying the video",
     "name": "description",
     "type": "text"
    },
    {
     "description": "Number of comments on the video, as displayed by YouTube (includes both top-level comments and replies in YouTube's count)",
     "name": "num_comments",
     "type": "number"
    },
    {
     "description": "Number of subscribers to the YouTube channel",
     "name": "subscribers",
     "type": "number"
    },
    {
     "description": "Information about the music used in the video. Only present when YouTube's Content ID system has identified music in the video",
     "name": "music",
     "type": "object"
    },
    {
     "description": "Unique identifier for the YouTube video",
     "name": "video_id",
     "type": "text"
    },
    {
     "description": "URL-encoded URL of the YouTube channel, derived from the channel's canonical browse endpoint",
     "name": "channel_url",
     "type": "url"
    },
    {
     "description": "URL of the preview image for the video",
     "name": "preview_image",
     "type": "image"
    },
    {
     "description": "The unique short identifier of the video, identical to video_id, used across all YouTube video types including regular videos and Shorts",
     "name": "shortcode",
     "type": "text"
    },
    {
     "description": "Indicates whether the channel is verified",
     "name": "verified",
     "type": "boolean"
    },
    {
     "description": "The display name of the YouTube channel as shown on the video page",
     "name": "handle_name",
     "type": "text"
    },
    {
     "description": "The URL of the avatar image of the YouTube channel",
     "name": "avatar_img_channel",
     "type": "url"
    },
    {
     "description": "Indicates whether the video contains a paid content overlay as declared by YouTube",
     "name": "is_sponsored",
     "type": "boolean"
    },
    {
     "description": "List of URLs of videos shown in the sidebar alongside the current video",
     "name": "related_videos",
     "type": "array"
    },
    {
     "description": "URL of the video's license as declared in YouTube's video metadata",
     "name": "license",
     "type": "url"
    },
    {
     "description": "Resolution of the primary video stream format, derived from YouTube's streaming data",
     "name": "viewport_frames",
     "type": "text"
    },
    {
     "description": "Current and optimal video resolution with frame rate, from YouTube's streaming format metadata",
     "name": "current_optimal_res",
     "type": "text"
    },
    {
     "description": "Video and audio codec strings formatted as video codec and audio codec, extracted from YouTube's adaptive streaming formats",
     "name": "codecs",
     "type": "text"
    },
    {
     "description": "Color primaries of the video stream, extracted from YouTube's adaptive format color info",
     "name": "color",
     "type": "text"
    },
    {
     "description": "Quality identifier of the first adaptive streaming format as reported by YouTube",
     "name": "quality",
     "type": "text"
    },
    {
     "description": "Human-readable video quality label as reported by YouTube",
     "name": "quality_label",
     "type": "text"
    },
    {
     "description": "Type of YouTube content inferred from the URL structure. Possible values: post for standard video, short for YouTube Short, or N/A",
     "name": "post_type",
     "type": "text"
    },
    {
     "description": "YouTube's internal channel ID, distinct from the channel handle",
     "name": "youtuber_id",
     "type": "text"
    },
    {
     "description": "Full plain-text transcript of the video, compiled from YouTube's caption tracks. English captions are preferred, falls back to the first available language if English is unavailable",
     "name": "transcript",
     "type": "text"
    },
    {
     "description": "Timestamped transcript segments from YouTube's caption tracks, each containing start time, end time, and duration in milliseconds, and the caption text",
     "name": "formatted_transcript",
     "type": "array"
    },
    {
     "description": "List of hashtags found in the video title or description, each with the hashtag text and its YouTube search link",
     "name": "hashtags",
     "type": "array"
    },
    {
     "description": "Tags of the video",
     "name": "tags",
     "type": "array"
    },
    {
     "description": "Videos shown as end-screen cards during the final seconds of the video, including timing in milliseconds and display style",
     "name": "next_recommended_videos",
     "type": "array"
    },
    {
     "description": "Videos recommended by YouTube in the sidebar alongside the current video",
     "name": "recommended_videos",
     "type": "array"
    },
    {
     "description": "List of caption and transcript languages available for this video on YouTube, including whether each track was auto-generated",
     "name": "transcript_language",
     "type": "array"
    },
    {
     "description": "List of chapter markers defined by the creator, each with a title, start time in milliseconds, and preview image",
     "name": "chapters",
     "type": "array"
    },
    {
     "description": "The language code requested by the caller for transcript retrieval, passed as an input parameter at collection time",
     "name": "transcription_language",
     "type": "text"
    },
    {
     "description": "Whether the video is age-restricted, inferred from a non-OK playability status combined with an age-related reason from YouTube",
     "name": "is_age_restricted",
     "type": "boolean"
    },
    {
     "description": "Plain-text percent-decoded version of the channel URL",
     "name": "channel_url_decoded",
     "type": "text"
    },
    {
     "description": "YouTube's content category assigned to the video, from YouTube's predefined category taxonomy",
     "name": "category",
     "type": "text"
    },
    {
     "description": "audio Tracks",
     "name": "audio_tracks",
     "type": "array"
    },
    {
     "description": "Indicates whether the video is designated as made for kids, inferred from the YouTube miniplayer playback mode",
     "name": "made_for_kids",
     "type": "boolean"
    },
    {
     "description": "User-facing notification text shown inside the video player",
     "name": "player_notification_text",
     "type": "text"
    },
    {
     "description": "Indicates whether the video has been labeled as AI-generated or significantly AI-altered, either by the creator or auto-detected by YouTube.",
     "name": "ai_content_label",
     "type": "boolean"
    },
    {
     "description": "Livestream status of the video, equivalent to yt-dlp's live_status. One of \"is_live\", \"was_live\", or \"not_live\", parsed from YouTube's info string (e.g. \"Streamed live 29 minutes ago\") or defaulted to \"not_live\" for regular videos",
     "name": "live_status",
     "type": "text"
    },
    {
     "description": "10 Most relevant comments of the video",
     "name": "comments",
     "type": "array"
    }
   ]
  },
  "discover_by_explore": {
   "input_schema": [
    {
     "name": "url",
     "required": true,
     "type": "url"
    },
    {
     "name": "all_tabs",
     "required": false,
     "type": "boolean"
    },
    {
     "name": "country",
     "required": false,
     "type": "text"
    }
   ],
   "output_fields": [
    {
     "name": "url",
     "type": "url"
    }
   ]
  },
  "discover_by_hashtag": {
   "input_schema": [
    {
     "name": "hashtag",
     "required": true,
     "type": "text"
    },
    {
     "name": "num_of_posts",
     "required": false,
     "type": "number"
    },
    {
     "name": "posts_to_not_include",
     "required": false,
     "type": "array"
    },
    {
     "name": "start_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "end_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "country",
     "required": false,
     "type": "text"
    }
   ],
   "output_fields": [
    {
     "name": "url",
     "type": "url"
    },
    {
     "name": "discovery_input",
     "type": "object"
    }
   ]
  },
  "discover_by_keyword": {
   "input_schema": [
    {
     "name": "keyword",
     "required": true,
     "type": "text"
    },
    {
     "name": "num_of_posts",
     "required": false,
     "type": "text"
    },
    {
     "name": "start_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "end_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "country",
     "required": false,
     "type": "text"
    },
    {
     "name": "include_shorts",
     "required": false,
     "type": "boolean"
    }
   ],
   "output_fields": [
    {
     "name": "url",
     "type": "url"
    },
    {
     "name": "discovery_input",
     "type": "object"
    },
    {
     "name": "input",
     "type": "input"
    },
    {
     "name": "warning",
     "type": "warning"
    },
    {
     "name": "error",
     "type": "error"
    }
   ]
  },
  "discover_by_podcast_url": {
   "input_schema": [
    {
     "name": "url",
     "required": true,
     "type": "url"
    }
   ],
   "output_fields": [
    {
     "name": "url",
     "type": "url"
    }
   ]
  },
  "discover_by_search_filters": {
   "input_schema": [
    {
     "name": "keyword_search",
     "required": true,
     "type": "text"
    },
    {
     "name": "upload_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "type",
     "required": false,
     "type": "text"
    },
    {
     "name": "duration",
     "required": false,
     "type": "text"
    },
    {
     "name": "features",
     "required": false,
     "type": "text"
    },
    {
     "name": "country",
     "required": false,
     "type": "text"
    },
    {
     "name": "sort_by",
     "required": false,
     "type": "text"
    }
   ],
   "output_fields": [
    {
     "name": "url",
     "type": "url"
    }
   ]
  },
  "discover_by_url": {
   "input_schema": [
    {
     "name": "url",
     "required": true,
     "type": "url"
    },
    {
     "name": "num_of_posts",
     "required": false,
     "type": "number"
    },
    {
     "name": "start_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "end_date",
     "required": false,
     "type": "text"
    },
    {
     "name": "order_by",
     "required": false,
     "type": "text"
    },
    {
     "name": "country",
     "required": false,
     "type": "text"
    },
    {
     "name": "time_period",
     "required": false,
     "type": "text"
    },
    {
     "name": "transcription_language",
     "required": false,
     "type": "text"
    }
   ],
   "output_fields": [
    {
     "name": "url",
     "type": "url"
    },
    {
     "name": "discovery_input",
     "type": "object"
    },
    {
     "description": "Number of subscribers to the YouTube channel, to be pushed to the PDP if it is not available on the shorts page",
     "name": "subscribers",
     "type": "number"
    },
    {
     "description": "The video's transcription language",
     "name": "transcription_language",
     "type": "text"
    }
   ]
  }
 },
 "domain": "youtube.com",
 "id": "gd_lk56epmy2i5g7lzu0k",
 "name": "Youtube - Videos posts"
}
