{
  "openapi": "3.0.0",
  "info": {
    "title": "YouTube通用搜索 API (V1)",
    "version": "1.0.0",
    "description": "通过TIKHUB通用搜索搜索YouTube，返回混合的视频、频道、播放列表和电影结果，包含续传令牌以及上传日期、类型、时长、功能和排序顺序的筛选条件，用于发现和监控。"
  },
  "servers": [
    {
      "url": "https://api.justoneapi.com",
      "description": "prod-global（默认）"
    },
    {
      "url": "http://47.117.133.51:30015",
      "description": "prod-cn（中国大陆地区可选）"
    }
  ],
  "paths": {
    "/api/youtube/search/v1": {
      "get": {
        "tags": [
          "YouTube"
        ],
        "summary": "通用搜索",
        "description": "通过TIKHUB通用搜索搜索YouTube，返回混合的视频、频道、播放列表和电影结果，包含续传令牌以及上传日期、类型、时长、功能和排序顺序的筛选条件，用于发现和监控。",
        "operationId": "getApiYoutubeSearchV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "此 API 服务的访问令牌。",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "搜索关键词。首次请求时必填；使用续传令牌时留空。",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "continuationToken",
            "in": "query",
            "description": "上一次响应返回的分页令牌。",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "uploadDate",
            "in": "query",
            "description": "按上传日期筛选结果。\n\n可用值：\n- `last_hour`：最近一小时内上传\n- `today`：今天上传\n- `this_week`：本周上传\n- `this_month`：本月上传\n- `this_year`：今年上传",
            "required": false,
            "schema": {
              "type": "string",
              "description": "YouTube search upload date filter",
              "enum": [
                "last_hour",
                "today",
                "this_week",
                "this_month",
                "this_year"
              ]
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "按结果类型筛选结果。\n\n可用值：\n- `video`：视频结果\n- `channel`：频道结果\n- `playlist`：播放列表结果\n- `movie`：电影结果",
            "required": false,
            "schema": {
              "type": "string",
              "description": "YouTube search result type filter",
              "enum": [
                "video",
                "channel",
                "playlist",
                "movie"
              ]
            }
          },
          {
            "name": "duration",
            "in": "query",
            "description": "按时长筛选视频结果。支持的请求值：short、medium、long。\n\n可用值：\n- `SHORT`：短于4分钟的短视频\n- `MEDIUM`：4到20分钟的中等视频\n- `LONG`：超过20分钟的长视频",
            "required": false,
            "schema": {
              "type": "string",
              "description": "YouTube search video duration filter",
              "enum": [
                "SHORT",
                "MEDIUM",
                "LONG"
              ]
            }
          },
          {
            "name": "features",
            "in": "query",
            "description": "用逗号分隔的功能筛选条件。支持的值：live、4k、hd、subtitles、creative_commons、360、vr180、3d、hdr。",
            "required": false,
            "schema": {
              "type": "string",
              "description": "YouTube search feature filter",
              "enum": [
                "live",
                "FOUR_K",
                "hd",
                "subtitles",
                "creative_commons",
                "THREE_SIXTY",
                "vr180",
                "THREE_D",
                "hdr"
              ]
            }
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "搜索结果的排序顺序。\n\n可用值：\n- `relevance`：按相关性排序\n- `upload_date`：按上传日期排序\n- `view_count`：按观看次数排序\n- `rating`：按评分排序",
            "required": false,
            "schema": {
              "type": "string",
              "description": "YouTube search sort order",
              "enum": [
                "relevance",
                "upload_date",
                "view_count",
                "rating"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "好的",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "0",
                        "100",
                        "101",
                        "202",
                        "300",
                        "301",
                        "302",
                        "303",
                        "400",
                        "404",
                        "500",
                        "600",
                        "601"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object"
                    },
                    "recordTime": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "requestId": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "25000900",
        "x-api-version": "v1",
        "x-highlights": []
      }
    }
  },
  "components": {}
}