Skip to main content
Glama

submit_batch

Submit Google and YouTube queries, including downloads to customer storage, as background jobs; returns IDs to read results with get_job.

Instructions

Submit Google and YouTube queries, including downloads to customer storage, as background jobs. Each queries entry uses source plus that source’s flat tool arguments, without mode or a params wrapper. Returns an id for each query; use get_job to read it. Each query consumes Credits; downloads reserve Credits and settle by uploaded bytes. Each download requires its own storage object. Your plan’s batch and pending limits apply. Do not automatically repeat a timed-out submission.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "queries": "<queries>"
    },
    "name": "submit_batch"
  }
}

Input Schema

NameRequiredDescriptionDefault
queriesYesQueries to submit, each with source and flat source arguments. Each item is billed separately.
response_formatNoAgent-readable presentation. MCP defaults to Markdown; json returns the original JSON text, text returns indented fields. Structured fields remain available. Does not change billing or the stored job.markdown

Output Schema

NameRequiredDescriptionDefault
codeNoMachine-readable error code when the operation fails.
chunkNoA substring of the selected document. Concatenate all chunks before parsing JSON or displaying the full document.
usageNoBilling information returned by the API.
detailNoAdditional problem detail returned by the API.
offsetNoStart position in UTF-16 code units.
messageNoError, delivery, or continuation instructions.
queriesNoAccepted queries, each with its own job ID and billing information.
encodingNoHow to read the assembled chunks. Parse JSON only for json.
result_idNoTemporary result identifier. Read subsequent chunks with get_result and the same API Key.
expires_atNoUTC expiry of the temporary result.
request_idNoFlashData request identifier for support and tracing.
http_statusNoUpstream HTTP status, when an upstream request was made.
next_offsetNoNext UTF-16 position; null when the result is complete.
total_creditsNoTotal Credits charged for the accepted batch.
total_charactersNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.1.1
    • 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"
      +  }
      +]
  2. First observedv0.1.0

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare openWorldHint=true, idempotentHint=false and destructiveHint=false, and the description meaningfully extends them: work runs as a background job, credits are consumed per query, downloads reserve credits then settle on uploaded bytes, and plan batch/pending limits apply. The retry warning is a genuine behavioral disclosure that matters given idempotentHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action, then billing, then constraints and the retry warning in descending priority. Dense but nearly every sentence carries operational value; the storage-sentence pair is slightly repetitive.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

A high-complexity polymorphic batch tool with an output schema and full annotation coverage, yet the description still covers async lifecycle, follow-up tool, cost model, limits and retry policy. Nothing an agent needs to submit correctly and handle the result is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real composition guidance the schema cannot convey: each queries entry is 'source plus that source's flat tool arguments, without mode or a params wrapper'. That explains how to build the oneOf variants from arguments the agent already knows from the sibling tools. Minor gap: response_format is not discussed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a concrete verb and resource ('Submit Google and YouTube queries ... as background jobs') and names the two domains covered, which distinguishes it from the single-source sibling tools like google_search and youtube_search. An agent can tell immediately this is the batch/async entry point.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit next-step routing ('use get_job to read it') and an explicit prohibition ('Do not automatically repeat a timed-out submission'), plus the constraint that each download needs its own storage object. It stops short of naming the individual per-source tools as the alternative for single queries, so the batch-vs-single decision is left implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.