changedInput schema / properties / queries / items / oneOf
Previous value: -[
- {
- "additionalProperties": false,
- "properties": {
- "autocorrect": {
- "description": "Whether Google may automatically correct the search query.",
- "type": "boolean"
- },
- "gl": {
- "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "hl": {
- "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "location": {
- "description": "Location used to localize Google search results.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "num": {
- "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "page": {
- "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "google_search",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "tbs": {
- "description": "Google search filter expression, such as a time-range filter.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "autocorrect": {
- "description": "Whether Google may automatically correct the search query.",
- "type": "boolean"
- },
- "gl": {
- "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "hl": {
- "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "location": {
- "description": "Location used to localize Google search results.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "num": {
- "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "page": {
- "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "google_images",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "tbs": {
- "description": "Google search filter expression, such as a time-range filter.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "autocorrect": {
- "description": "Whether Google may automatically correct the search query.",
- "type": "boolean"
- },
- "gl": {
- "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "hl": {
- "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "location": {
- "description": "Location used to localize Google search results.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "num": {
- "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "page": {
- "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "google_news",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "tbs": {
- "description": "Google search filter expression, such as a time-range filter.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "autocorrect": {
- "description": "Whether Google may automatically correct the search query.",
- "type": "boolean"
- },
- "gl": {
- "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "hl": {
- "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "location": {
- "description": "Location used to localize Google search results.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "num": {
- "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "page": {
- "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "google_shopping",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "tbs": {
- "description": "Google search filter expression, such as a time-range filter.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "autocorrect": {
- "description": "Whether Google may automatically correct the search query.",
- "type": "boolean"
- },
- "gl": {
- "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "hl": {
- "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "location": {
- "description": "Location used to localize Google search results.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "num": {
- "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "page": {
- "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "google_videos",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "tbs": {
- "description": "Google search filter expression, such as a time-range filter.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "autocorrect": {
- "description": "Whether Google may automatically correct the search query.",
- "type": "boolean"
- },
- "gl": {
- "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "hl": {
- "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "location": {
- "description": "Location used to localize Google search results.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "num": {
- "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "page": {
- "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "google_places",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "tbs": {
- "description": "Google search filter expression, such as a time-range filter.",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "filters": {
- "additionalProperties": false,
- "description": "YouTube search filters. Omit or use null for no filters.",
- "properties": {
- "360": {
- "description": "Apply the YouTube 360-degree video filter.",
- "type": "boolean"
- },
- "3d": {
- "description": "Apply the YouTube 3D filter.",
- "type": "boolean"
- },
- "4k": {
- "description": "Apply the YouTube 4K filter.",
- "type": "boolean"
- },
- "creative_commons": {
- "description": "Apply the Creative Commons label filter; this does not grant usage rights.",
- "type": "boolean"
- },
- "duration": {
- "description": "Filter by video length in minutes.",
- "enum": [
- "<4",
- "4-20",
- ">20"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "hd": {
- "description": "Apply the YouTube HD filter.",
- "type": "boolean"
- },
- "hdr": {
- "description": "Apply the YouTube HDR filter.",
- "type": "boolean"
- },
- "live": {
- "description": "Apply the YouTube live filter.",
- "type": "boolean"
- },
- "location": {
- "description": "Apply the YouTube location-tagged content filter.",
- "type": "boolean"
- },
- "purchased": {
- "description": "Apply the YouTube purchased-content filter.",
- "type": "boolean"
- },
- "sort_by": {
- "description": "YouTube result ordering.",
- "enum": [
- "rating",
- "relevance",
- "view_count",
- "upload_date"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "subtitles": {
- "description": "Apply the YouTube subtitles filter.",
- "type": "boolean"
- },
- "type": {
- "description": "YouTube content type to include.",
- "enum": [
- "video",
- "channel",
- "playlist",
- "movie"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "upload_date": {
- "description": "Relative upload-time window.",
- "enum": [
- "today",
- "last_hour",
- "this_week",
- "this_month",
- "this_year"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "vr180": {
- "description": "Apply the YouTube VR180 filter.",
- "type": "boolean"
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "max_results": {
- "default": 20,
- "description": "Maximum number of YouTube search results requested; the source-specific limit applies.",
- "maximum": 20,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "youtube_search",
- "description": "Data source for this batch item.",
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "filters": {
- "additionalProperties": false,
- "description": "YouTube search filters. Omit or use null for no filters.",
- "properties": {
- "360": {
- "description": "Apply the YouTube 360-degree video filter.",
- "type": "boolean"
- },
- "3d": {
- "description": "Apply the YouTube 3D filter.",
- "type": "boolean"
- },
- "4k": {
- "description": "Apply the YouTube 4K filter.",
- "type": "boolean"
- },
- "creative_commons": {
- "description": "Apply the Creative Commons label filter; this does not grant usage rights.",
- "type": "boolean"
- },
- "duration": {
- "description": "Filter by video length in minutes.",
- "enum": [
- "<4",
- "4-20",
- ">20"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "hd": {
- "description": "Apply the YouTube HD filter.",
- "type": "boolean"
- },
- "hdr": {
- "description": "Apply the YouTube HDR filter.",
- "type": "boolean"
- },
- "live": {
- "description": "Apply the YouTube live filter.",
- "type": "boolean"
- },
- "location": {
- "description": "Apply the YouTube location-tagged content filter.",
- "type": "boolean"
- },
- "purchased": {
- "description": "Apply the YouTube purchased-content filter.",
- "type": "boolean"
- },
- "sort_by": {
- "description": "YouTube result ordering.",
- "enum": [
- "rating",
- "relevance",
- "view_count",
- "upload_date"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "subtitles": {
- "description": "Apply the YouTube subtitles filter.",
- "type": "boolean"
- },
- "type": {
- "description": "YouTube content type to include.",
- "enum": [
- "video",
- "channel",
- "playlist",
- "movie"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "upload_date": {
- "description": "Relative upload-time window.",
- "enum": [
- "today",
- "last_hour",
- "this_week",
- "this_month",
- "this_year"
- ],
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "vr180": {
- "description": "Apply the YouTube VR180 filter.",
- "type": "boolean"
- }
- },
- "type": [
- "object",
- "null"
- ]
- },
- "max_results": {
- "default": 20,
- "description": "Maximum number of YouTube search results requested; the source-specific limit applies.",
- "maximum": 700,
- "minimum": 1,
- "type": "integer"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "youtube_search_extended",
- "description": "Data source for this batch item.",
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "include_chapters": {
- "default": true,
- "description": "Include chapter metadata when available for the video.",
- "type": "boolean"
- },
- "include_formats": {
- "default": true,
- "description": "Include available media format metadata in the response; does not download media.",
- "type": "boolean"
- },
- "source": {
- "const": "youtube_metadata",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "video_id": {
- "description": "The 11-character YouTube video ID, not the full video URL.",
- "maxLength": 11,
- "minLength": 11,
- "pattern": "^[A-Za-z0-9_-]{11}$",
- "type": "string"
- }
- },
- "required": [
- "source",
- "video_id"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "auto": {
- "default": true,
- "description": "true selects automatically generated captions; false selects manually provided captions. Does not fall back between the two.",
- "type": "boolean"
- },
- "language": {
- "description": "Omit to prefer en-orig and fall back to en, returning one track. A string selects that exact language. An array of 1–10 distinct codes returns tracks and per-language errors. The selected caption source applies to every language.",
- "oneOf": [
- {
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- {
- "items": {
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "maxItems": 10,
- "minItems": 1,
- "type": "array",
- "uniqueItems": true
- }
- ]
- },
- "source": {
- "const": "youtube_transcript",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "video_id": {
- "description": "The 11-character YouTube video ID, not the full video URL.",
- "maxLength": 11,
- "minLength": 11,
- "pattern": "^[A-Za-z0-9_-]{11}$",
- "type": "string"
- }
- },
- "required": [
- "source",
- "video_id"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "auto": {
- "default": false,
- "description": "true selects automatically generated captions; false selects manually provided captions. Does not fall back between the two.",
- "type": "boolean"
- },
- "language": {
- "description": "Omit to prefer en-orig and fall back to en, returning one track. A string selects that exact language. An array of 1–10 distinct codes returns tracks and per-language errors. The selected caption source applies to every language.",
- "oneOf": [
- {
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- {
- "items": {
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "maxItems": 10,
- "minItems": 1,
- "type": "array",
- "uniqueItems": true
- }
- ]
- },
- "source": {
- "const": "youtube_captions",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "video_id": {
- "description": "The 11-character YouTube video ID, not the full video URL.",
- "maxLength": 11,
- "minLength": 11,
- "pattern": "^[A-Za-z0-9_-]{11}$",
- "type": "string"
- }
- },
- "required": [
- "source",
- "video_id"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "source": {
- "const": "youtube_trainability",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "video_id": {
- "description": "The 11-character YouTube video ID, not the full video URL.",
- "maxLength": 11,
- "minLength": 11,
- "pattern": "^[A-Za-z0-9_-]{11}$",
- "type": "string"
- }
- },
- "required": [
- "source",
- "video_id"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "handle": {
- "description": "YouTube channel handle used to identify the channel.",
- "maxLength": 100,
- "minLength": 1,
- "type": "string"
- },
- "source": {
- "const": "youtube_channel",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "video_limit": {
- "default": 20,
- "description": "Maximum number of recent videos to return for the channel.",
- "maximum": 100,
- "minimum": 1,
- "type": "integer"
- }
- },
- "required": [
- "source",
- "handle"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "language": {
- "default": "en",
- "description": "Language code for YouTube autocomplete suggestions.",
- "maxLength": 35,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9-]+$",
- "type": "string"
- },
- "query": {
- "description": "Search text to send to this data source.",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "region": {
- "default": "US",
- "description": "Two-letter region code for YouTube suggestions.",
- "maxLength": 2,
- "minLength": 2,
- "pattern": "^[A-Za-z]{2}$",
- "type": "string"
- },
- "source": {
- "const": "youtube_suggestions",
- "description": "Data source for this batch item.",
- "type": "string"
- }
- },
- "required": [
- "source",
- "query"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "audio_language": {
- "default": "default",
- "description": "Select the default audio track or the original-language track.",
- "enum": [
- "default",
- "original"
- ],
- "maxLength": 8,
- "minLength": 1,
- "type": "string"
- },
- "audio_quality": {
- "default": "best",
- "description": "Best available audio or the requested audio bitrate in kbps.",
- "enum": [
- "best",
- "320",
- "256",
- "192",
- "128"
- ],
- "maxLength": 10,
- "minLength": 1,
- "type": "string"
- },
- "download_type": {
- "default": "audio_video",
- "description": "Download combined audio/video, video only, or audio only.",
- "enum": [
- "audio_video",
- "video",
- "audio"
- ],
- "maxLength": 11,
- "minLength": 1,
- "type": "string"
- },
- "end_at": {
- "description": "End of the requested clip in HH:MM:SS; must be after start_at.",
- "maxLength": 8,
- "minLength": 1,
- "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
- "type": "string"
- },
- "fps": {
- "description": "Frame-rate selection, for example <=30 or ==60.",
- "maxLength": 6,
- "minLength": 1,
- "pattern": "^(?:>=|<=|==)(?:[1-9]\\d?|1\\d\\d|2[0-3]\\d|240)$",
- "type": "string"
- },
- "output_format": {
- "description": "Video defaults to mp4 (also webm/mkv); audio defaults to m4a (also mp3/opus).",
- "enum": [
- "mp4",
- "webm",
- "mkv",
- "m4a",
- "mp3",
- "opus"
- ],
- "type": "string"
- },
- "source": {
- "const": "youtube_download",
- "description": "Data source for this batch item.",
- "type": "string"
- },
- "start_at": {
- "description": "Start of the requested clip in HH:MM:SS.",
- "maxLength": 8,
- "minLength": 1,
- "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
- "type": "string"
- },
- "storage": {
- "additionalProperties": false,
- "description": "Customer-owned destination, using the same fields as Download API params.storage. Supply credentials from your configured storage; do not invent values or display secrets. GCS uses service_account; Azure uses account_name and a container SAS with write permission; other providers use access_key/secret_key and provider endpoint/region as needed.",
- "properties": {
- "access_key": {
- "maxLength": 4096,
- "type": "string"
- },
- "account_name": {
- "pattern": "^[a-z0-9]{3,24}$",
- "type": "string"
- },
- "endpoint_url": {
- "description": "Provider endpoint, required for S3-compatible storage. Must be reachable from the download Worker.",
- "maxLength": 4096,
- "type": "string"
- },
- "object_prefix": {
- "description": "Optional object folder prefix. Use a distinct prefix when keeping multiple versions of a video.",
- "maxLength": 513,
- "minLength": 1,
- "type": "string"
- },
- "region": {
- "maxLength": 4096,
- "type": "string"
- },
- "sas_token": {
- "description": "Azure container SAS with write permission; never return this secret to the user in output.",
- "maxLength": 4097,
- "type": "string"
- },
- "secret_key": {
- "maxLength": 4096,
- "type": "string"
- },
- "service_account": {
- "additionalProperties": true,
- "properties": {
- "client_email": {
- "minLength": 1,
- "type": "string"
- },
- "private_key": {
- "maxLength": 16384,
- "minLength": 1,
- "type": "string"
- },
- "project_id": {
- "maxLength": 256,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "project_id",
- "client_email",
- "private_key"
- ],
- "type": "object"
- },
- "storage_type": {
- "enum": [
- "azure",
- "bos",
- "cos",
- "gcs",
- "oss",
- "s3",
- "s3_compatible",
- "tos"
- ],
- "type": "string"
- },
- "storage_url": {
- "description": "Bucket name (Azure: container name). Not a local path or a full object URL.",
- "maxLength": 1024,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "storage_type",
- "storage_url"
- ],
- "type": "object"
- },
- "upload_metadata": {
- "default": false,
- "description": "Also upload video metadata to the supplied customer storage.",
- "type": "boolean"
- },
- "video_id": {
- "description": "The 11-character YouTube video ID, not the full video URL.",
- "maxLength": 11,
- "minLength": 11,
- "pattern": "^[A-Za-z0-9_-]{11}$",
- "type": "string"
- },
- "video_quality": {
- "default": "<=720",
- "description": "Requested video height selection in pixels; availability depends on the video.",
- "enum": [
- "best",
- "worst",
- "<=144",
- "==144",
- ">=144",
- "<=360",
- "==360",
- ">=360",
- "<=480",
- "==480",
- ">=480",
- "<=720",
- "==720",
- ">=720",
- "<=1080",
- "==1080",
- ">=1080",
- "<=1440",
- "==1440",
- ">=1440",
- "<=2160",
- "==2160",
- ">=2160",
- "<=4320",
- "==4320",
- ">=4320"
- ],
- "maxLength": 40,
- "minLength": 1,
- "type": "string"
- },
- "yt_dlp_format": {
- "description": "Advanced yt-dlp format selector for the download.",
- "maxLength": 1024,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "source",
- "video_id",
- "storage"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "autocorrect": {
+ "description": "Whether Google may automatically correct the search query.",
+ "type": "boolean"
+ },
+ "gl": {
+ "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "hl": {
+ "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "location": {
+ "description": "Location used to localize Google search results.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "num": {
+ "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "page": {
+ "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "google_search",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "tbs": {
+ "description": "Google search filter expression, such as a time-range filter.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "autocorrect": {
+ "description": "Whether Google may automatically correct the search query.",
+ "type": "boolean"
+ },
+ "gl": {
+ "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "hl": {
+ "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "location": {
+ "description": "Location used to localize Google search results.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "num": {
+ "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "page": {
+ "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "google_images",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "tbs": {
+ "description": "Google search filter expression, such as a time-range filter.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "autocorrect": {
+ "description": "Whether Google may automatically correct the search query.",
+ "type": "boolean"
+ },
+ "gl": {
+ "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "hl": {
+ "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "location": {
+ "description": "Location used to localize Google search results.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "num": {
+ "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "page": {
+ "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "google_news",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "tbs": {
+ "description": "Google search filter expression, such as a time-range filter.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "autocorrect": {
+ "description": "Whether Google may automatically correct the search query.",
+ "type": "boolean"
+ },
+ "gl": {
+ "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "hl": {
+ "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "location": {
+ "description": "Location used to localize Google search results.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "num": {
+ "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "page": {
+ "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "google_shopping",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "tbs": {
+ "description": "Google search filter expression, such as a time-range filter.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "autocorrect": {
+ "description": "Whether Google may automatically correct the search query.",
+ "type": "boolean"
+ },
+ "gl": {
+ "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "hl": {
+ "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "location": {
+ "description": "Location used to localize Google search results.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "num": {
+ "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "page": {
+ "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "google_videos",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "tbs": {
+ "description": "Google search filter expression, such as a time-range filter.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "autocorrect": {
+ "description": "Whether Google may automatically correct the search query.",
+ "type": "boolean"
+ },
+ "gl": {
+ "description": "Country code. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "hl": {
+ "description": "Interface language. Set explicitly when needed; omitted values use the search provider’s behavior.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "location": {
+ "description": "Location used to localize Google search results.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "num": {
+ "description": "Requested result count. Actual count varies by query and search type; no fixed value is added when omitted.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "page": {
+ "description": "Requested page. Set explicitly for pagination; each page is a separate query.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "google_places",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "tbs": {
+ "description": "Google search filter expression, such as a time-range filter.",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "filters": {
+ "additionalProperties": false,
+ "description": "YouTube search filters. Omit or use null for no filters.",
+ "properties": {
+ "360": {
+ "description": "Apply the YouTube 360-degree video filter.",
+ "type": "boolean"
+ },
+ "3d": {
+ "description": "Apply the YouTube 3D filter.",
+ "type": "boolean"
+ },
+ "4k": {
+ "description": "Apply the YouTube 4K filter.",
+ "type": "boolean"
+ },
+ "creative_commons": {
+ "description": "Apply the Creative Commons label filter; this does not grant usage rights.",
+ "type": "boolean"
+ },
+ "duration": {
+ "description": "Filter by video length in minutes.",
+ "enum": [
+ "<4",
+ "4-20",
+ ">20"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "hd": {
+ "description": "Apply the YouTube HD filter.",
+ "type": "boolean"
+ },
+ "hdr": {
+ "description": "Apply the YouTube HDR filter.",
+ "type": "boolean"
+ },
+ "live": {
+ "description": "Apply the YouTube live filter.",
+ "type": "boolean"
+ },
+ "location": {
+ "description": "Apply the YouTube location-tagged content filter.",
+ "type": "boolean"
+ },
+ "purchased": {
+ "description": "Apply the YouTube purchased-content filter.",
+ "type": "boolean"
+ },
+ "sort_by": {
+ "description": "YouTube result ordering.",
+ "enum": [
+ "rating",
+ "relevance",
+ "view_count",
+ "upload_date"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "subtitles": {
+ "description": "Apply the YouTube subtitles filter.",
+ "type": "boolean"
+ },
+ "type": {
+ "description": "YouTube content type to include.",
+ "enum": [
+ "video",
+ "channel",
+ "playlist",
+ "movie"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "upload_date": {
+ "description": "Relative upload-time window.",
+ "enum": [
+ "today",
+ "last_hour",
+ "this_week",
+ "this_month",
+ "this_year"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "vr180": {
+ "description": "Apply the YouTube VR180 filter.",
+ "type": "boolean"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "max_results": {
+ "default": 20,
+ "description": "Maximum number of YouTube search results requested; the source-specific limit applies.",
+ "maximum": 20,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "youtube_search",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "filters": {
+ "additionalProperties": false,
+ "description": "YouTube search filters. Omit or use null for no filters.",
+ "properties": {
+ "360": {
+ "description": "Apply the YouTube 360-degree video filter.",
+ "type": "boolean"
+ },
+ "3d": {
+ "description": "Apply the YouTube 3D filter.",
+ "type": "boolean"
+ },
+ "4k": {
+ "description": "Apply the YouTube 4K filter.",
+ "type": "boolean"
+ },
+ "creative_commons": {
+ "description": "Apply the Creative Commons label filter; this does not grant usage rights.",
+ "type": "boolean"
+ },
+ "duration": {
+ "description": "Filter by video length in minutes.",
+ "enum": [
+ "<4",
+ "4-20",
+ ">20"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "hd": {
+ "description": "Apply the YouTube HD filter.",
+ "type": "boolean"
+ },
+ "hdr": {
+ "description": "Apply the YouTube HDR filter.",
+ "type": "boolean"
+ },
+ "live": {
+ "description": "Apply the YouTube live filter.",
+ "type": "boolean"
+ },
+ "location": {
+ "description": "Apply the YouTube location-tagged content filter.",
+ "type": "boolean"
+ },
+ "purchased": {
+ "description": "Apply the YouTube purchased-content filter.",
+ "type": "boolean"
+ },
+ "sort_by": {
+ "description": "YouTube result ordering.",
+ "enum": [
+ "rating",
+ "relevance",
+ "view_count",
+ "upload_date"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "subtitles": {
+ "description": "Apply the YouTube subtitles filter.",
+ "type": "boolean"
+ },
+ "type": {
+ "description": "YouTube content type to include.",
+ "enum": [
+ "video",
+ "channel",
+ "playlist",
+ "movie"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "upload_date": {
+ "description": "Relative upload-time window.",
+ "enum": [
+ "today",
+ "last_hour",
+ "this_week",
+ "this_month",
+ "this_year"
+ ],
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "vr180": {
+ "description": "Apply the YouTube VR180 filter.",
+ "type": "boolean"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "max_results": {
+ "default": 20,
+ "description": "Maximum number of YouTube search results requested; the source-specific limit applies.",
+ "maximum": 700,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "youtube_search_extended",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "include_chapters": {
+ "default": true,
+ "description": "Include chapter metadata when available for the video.",
+ "type": "boolean"
+ },
+ "include_formats": {
+ "default": true,
+ "description": "Include available media format metadata in the response; does not download media.",
+ "type": "boolean"
+ },
+ "source": {
+ "const": "youtube_metadata",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "video_id": {
+ "description": "The 11-character YouTube video ID, not the full video URL.",
+ "maxLength": 11,
+ "minLength": 11,
+ "pattern": "^[A-Za-z0-9_-]{11}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "video_id"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "auto": {
+ "default": true,
+ "description": "true selects automatically generated captions; false selects manually provided captions. Does not fall back between the two.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "Omit to prefer en-orig and fall back to en, returning one track. A string selects that exact language. An array of 1–10 distinct codes returns tracks and per-language errors. The selected caption source applies to every language.",
+ "oneOf": [
+ {
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ {
+ "items": {
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "maxItems": 10,
+ "minItems": 1,
+ "type": "array",
+ "uniqueItems": true
+ }
+ ]
+ },
+ "source": {
+ "const": "youtube_transcript",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "video_id": {
+ "description": "The 11-character YouTube video ID, not the full video URL.",
+ "maxLength": 11,
+ "minLength": 11,
+ "pattern": "^[A-Za-z0-9_-]{11}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "video_id"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "auto": {
+ "default": false,
+ "description": "true selects automatically generated captions; false selects manually provided captions. Does not fall back between the two.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "Omit to prefer en-orig and fall back to en, returning one track. A string selects that exact language. An array of 1–10 distinct codes returns tracks and per-language errors. The selected caption source applies to every language.",
+ "oneOf": [
+ {
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ {
+ "items": {
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "maxItems": 10,
+ "minItems": 1,
+ "type": "array",
+ "uniqueItems": true
+ }
+ ]
+ },
+ "source": {
+ "const": "youtube_captions",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "video_id": {
+ "description": "The 11-character YouTube video ID, not the full video URL.",
+ "maxLength": 11,
+ "minLength": 11,
+ "pattern": "^[A-Za-z0-9_-]{11}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "video_id"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "source": {
+ "const": "youtube_trainability",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "video_id": {
+ "description": "The 11-character YouTube video ID, not the full video URL.",
+ "maxLength": 11,
+ "minLength": 11,
+ "pattern": "^[A-Za-z0-9_-]{11}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "video_id"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "handle": {
+ "description": "YouTube channel handle used to identify the channel.",
+ "maxLength": 100,
+ "minLength": 1,
+ "type": "string"
+ },
+ "source": {
+ "const": "youtube_channel",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "video_limit": {
+ "default": 20,
+ "description": "Maximum number of recent videos to return for the channel.",
+ "maximum": 100,
+ "minimum": 1,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "source",
+ "handle"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "language": {
+ "default": "en",
+ "description": "Language code for YouTube autocomplete suggestions.",
+ "maxLength": 35,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9-]+$",
+ "type": "string"
+ },
+ "query": {
+ "description": "Search text to send to this data source.",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "region": {
+ "default": "US",
+ "description": "Two-letter region code for YouTube suggestions.",
+ "maxLength": 2,
+ "minLength": 2,
+ "pattern": "^[A-Za-z]{2}$",
+ "type": "string"
+ },
+ "source": {
+ "const": "youtube_suggestions",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "query"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "audio_language": {
+ "default": "default",
+ "description": "Select the default audio track or the original-language track.",
+ "enum": [
+ "default",
+ "original"
+ ],
+ "maxLength": 8,
+ "minLength": 1,
+ "type": "string"
+ },
+ "audio_quality": {
+ "default": "best",
+ "description": "Best available audio or the requested audio bitrate in kbps.",
+ "enum": [
+ "best",
+ "320",
+ "256",
+ "192",
+ "128"
+ ],
+ "maxLength": 10,
+ "minLength": 1,
+ "type": "string"
+ },
+ "download_type": {
+ "default": "audio_video",
+ "description": "Download combined audio/video, video only, or audio only.",
+ "enum": [
+ "audio_video",
+ "video",
+ "audio"
+ ],
+ "maxLength": 11,
+ "minLength": 1,
+ "type": "string"
+ },
+ "end_at": {
+ "description": "End of the requested clip in HH:MM:SS; must be after start_at.",
+ "maxLength": 8,
+ "minLength": 1,
+ "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
+ "type": "string"
+ },
+ "fps": {
+ "description": "Frame-rate selection, for example <=30 or ==60.",
+ "maxLength": 6,
+ "minLength": 1,
+ "pattern": "^(?:>=|<=|==)(?:[1-9]\\d?|1\\d\\d|2[0-3]\\d|240)$",
+ "type": "string"
+ },
+ "output_format": {
+ "description": "Video defaults to mp4 (also webm/mkv); audio defaults to m4a (also mp3/opus).",
+ "enum": [
+ "mp4",
+ "webm",
+ "mkv",
+ "m4a",
+ "mp3",
+ "opus"
+ ],
+ "type": "string"
+ },
+ "source": {
+ "const": "youtube_download",
+ "description": "Data source for this batch item.",
+ "type": "string"
+ },
+ "start_at": {
+ "description": "Start of the requested clip in HH:MM:SS.",
+ "maxLength": 8,
+ "minLength": 1,
+ "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
+ "type": "string"
+ },
+ "storage": {
+ "additionalProperties": false,
+ "description": "Customer-owned destination, using the same fields as Download API params.storage. Supply credentials from your configured storage; do not invent values or display secrets. GCS uses service_account; Azure uses account_name and a container SAS with write permission; other providers use access_key/secret_key and provider endpoint/region as needed.",
+ "properties": {
+ "access_key": {
+ "maxLength": 4096,
+ "type": "string"
+ },
+ "account_name": {
+ "pattern": "^[a-z0-9]{3,24}$",
+ "type": "string"
+ },
+ "endpoint_url": {
+ "description": "Provider endpoint, required for S3-compatible storage. Must be reachable from the download Worker.",
+ "maxLength": 4096,
+ "type": "string"
+ },
+ "object_prefix": {
+ "description": "Optional object folder prefix. Use a distinct prefix when keeping multiple versions of a video.",
+ "maxLength": 513,
+ "minLength": 1,
+ "type": "string"
+ },
+ "region": {
+ "maxLength": 4096,
+ "type": "string"
+ },
+ "sas_token": {
+ "description": "Azure container SAS with write permission; never return this secret to the user in output.",
+ "maxLength": 4097,
+ "type": "string"
+ },
+ "secret_key": {
+ "maxLength": 4096,
+ "type": "string"
+ },
+ "service_account": {
+ "additionalProperties": true,
+ "properties": {
+ "client_email": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "private_key": {
+ "maxLength": 16384,
+ "minLength": 1,
+ "type": "string"
+ },
+ "project_id": {
+ "maxLength": 256,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "project_id",
+ "client_email",
+ "private_key"
+ ],
+ "type": "object"
+ },
+ "session_token": {
+ "description": "Optional session token for s3, s3_compatible, oss, cos, bos or tos, with the matching temporary access_key and secret_key issued by that storage provider. The provider must support temporary credentials. Use AWS/BOS/TOS SessionToken, OSS SecurityToken or COS Token. Credentials must remain valid through queueing, download and upload retries. Never display this secret.",
+ "maxLength": 16384,
+ "minLength": 1,
+ "type": "string",
+ "writeOnly": true
+ },
+ "storage_type": {
+ "enum": [
+ "azure",
+ "bos",
+ "cos",
+ "gcs",
+ "oss",
+ "s3",
+ "s3_compatible",
+ "tos"
+ ],
+ "type": "string"
+ },
+ "storage_url": {
+ "description": "Bucket name (Azure: container name). Not a local path or a full object URL.",
+ "maxLength": 1024,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "storage_type",
+ "storage_url"
+ ],
+ "type": "object"
+ },
+ "upload_metadata": {
+ "default": false,
+ "description": "Also upload video metadata to the supplied customer storage.",
+ "type": "boolean"
+ },
+ "video_id": {
+ "description": "The 11-character YouTube video ID, not the full video URL.",
+ "maxLength": 11,
+ "minLength": 11,
+ "pattern": "^[A-Za-z0-9_-]{11}$",
+ "type": "string"
+ },
+ "video_quality": {
+ "default": "<=720",
+ "description": "Requested video height selection in pixels; availability depends on the video.",
+ "enum": [
+ "best",
+ "worst",
+ "<=144",
+ "==144",
+ ">=144",
+ "<=360",
+ "==360",
+ ">=360",
+ "<=480",
+ "==480",
+ ">=480",
+ "<=720",
+ "==720",
+ ">=720",
+ "<=1080",
+ "==1080",
+ ">=1080",
+ "<=1440",
+ "==1440",
+ ">=1440",
+ "<=2160",
+ "==2160",
+ ">=2160",
+ "<=4320",
+ "==4320",
+ ">=4320"
+ ],
+ "maxLength": 40,
+ "minLength": 1,
+ "type": "string"
+ },
+ "yt_dlp_format": {
+ "description": "Advanced yt-dlp format selector for the download.",
+ "maxLength": 1024,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "source",
+ "video_id",
+ "storage"
+ ],
+ "type": "object"
+ }
+]