{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/flashdata-dev/json-schema/flashdata-dev-async-query-youtube-search-extended-schema.json",
  "title": "AsyncQuery_youtube_search_extended",
  "description": "YouTube Extended Search. Supported modes: realtime, async, batch. Provider-specific storage requirements and conditional media options are validated by the server; see the source reference.",
  "x-generated": "2026-11-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/flashdata-dev-openapi.json#/components/schemas/AsyncQuery_youtube_search_extended",
  "type": "object",
  "required": [
    "source",
    "query"
  ],
  "properties": {
    "source": {
      "type": "string",
      "const": "youtube_search_extended"
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "params": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "max_results": {
          "type": "integer",
          "minimum": 1,
          "maximum": 700,
          "default": 20
        },
        "filters": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": false,
          "properties": {
            "360": {
              "type": "boolean"
            },
            "duration": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000,
              "enum": [
                "<4",
                "4-20",
                ">20"
              ]
            },
            "sort_by": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000,
              "enum": [
                "rating",
                "relevance",
                "view_count",
                "upload_date"
              ]
            },
            "type": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000,
              "enum": [
                "video",
                "channel",
                "playlist",
                "movie"
              ]
            },
            "upload_date": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000,
              "enum": [
                "today",
                "last_hour",
                "this_week",
                "this_month",
                "this_year"
              ]
            },
            "3d": {
              "type": "boolean"
            },
            "4k": {
              "type": "boolean"
            },
            "creative_commons": {
              "type": "boolean"
            },
            "hd": {
              "type": "boolean"
            },
            "hdr": {
              "type": "boolean"
            },
            "live": {
              "type": "boolean"
            },
            "location": {
              "type": "boolean"
            },
            "purchased": {
              "type": "boolean"
            },
            "subtitles": {
              "type": "boolean"
            },
            "vr180": {
              "type": "boolean"
            }
          }
        }
      }
    },
    "callback_url": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 2048,
      "description": "Async and batch only. Public HTTPS URL on port 443 without credentials or a fragment. Omit, null or empty string disables callbacks. Server validates public reachability."
    }
  }
}