Tikhub · Social

Shorts搜索（原始数据，推荐使用V2）/Shorts search (raw data, recommend V2)

[中文] ### ⚠️ 推荐使用 V2 版本: - 本接口返回 YouTube 原始数据结构，需要自行解析 - 清洗过的数据版本请使用 /get_shorts_search_v2 接口，返回结构化的 Shorts 列表数据，自动过滤非 Shorts 内容 ### 用途: - YouTube Shorts短视频专门搜索，使用原生YouTube API接口 ### 特点: - 🎬 专门搜索YouTube Shorts短视频（<60秒） - 🔍 支持多种过滤条件和排序方式 - 📱 优化的移动端短视频内容 - ⚡ 智能过滤：首次请求可能返回混合内容（长视频+短视频），默认自动过滤长视频 ### 重要说明 - YouTube Shorts搜索机制: 根据YouTube的搜索逻辑，Shorts搜索有以下特性： 1. 首次请求（无continuationtoken）：可能返回混合内容（部分长视频 + 部分短视频） 2. **后续请求**（有continuationtoken）：仅返回纯短视频内容 3. 解决方案： - 方案A：使用 filtermixedcontent=true（默认），自动过滤掉长视频 - 方案B：使用第一次返回的 continuationtoken 进行第二次请求，获取纯Shorts内容 - 方案C：设置 filtermixedcontent=false，获取原始混合内容 ### 参数详解: #### 📌 必选参数 (Required Parameters): **searchquery (string) - 作用: 搜索关键字，用于匹配Shorts视频的标题、描述等内容 - 格式: 任意字符串 - 示例: "Python编程", "gaming", "cooking tutorial" - 注意: 支持中英文及其他语言，空格会被自动处理 #### ⚙️ 可选参数 - 基础设置 (Optional Parameters - Basic Settings): languagecode** (string, 可选) - **作用**: 设置搜索结果的显示语言，影响返回内容的语言偏好 - **默认值**: "en-US" - **可用值**: - "zh-CN" - 简体中文 - "zh-TW" - 繁体中文 - "en-US" - 英语（美国） - "en-GB" - 英语（英国） - "ja-JP" - 日语 - "ko-KR" - 韩语 - "es-ES" - 西班牙语 - "fr-FR" - 法语 - "de-DE" - 德语 - 其他符合IETF BCP 47标准的语言代码 - **示例**: languagecode=zh-CN - 影响: 会影响搜索算法的语言匹配和结果排序 country_code (string, 可选) - 作用: 设置地区/国家代码，影响搜索结果的地域相关性和内容可用性 - 默认值: "US" - 可用值: - "US" - 美国 - "CN" - 中国 - "JP" - 日本 - "KR" - 韩国 - "GB" - 英国 - "DE" - 德国 - "FR" - 法国 - "CA" - 加拿大 - 其他符合ISO 3166-1 alpha-2标准的国家代码 - 示例: countrycode=JP - **影响**: 某些Shorts可能因地区限制而不可见 **timezone (string, 可选) - 作用: 设置时区，影响时间相关过滤器（如"今天"、"本周"）的计算 - 默认值: "America/Los_Angeles" - 可用值: 符合IANA时区数据库的时区标识符 - "America/Los_Angeles" - 美国太平洋时区 - "America/New_York" - 美国东部时区 - "Asia/Shanghai" - 中国时区 - "Asia/Tokyo" - 日本时区 - "Europe/London" - 英国时区 - "Europe/Paris" - 法国时区 - 示例: time_zone=Asia/Shanghai - 影响: 结合upload_time参数使用时，决定"今天"等时间段的具体范围 filtermixedcontent (boolean, 可选) - 作用**: 控制是否自动过滤掉响应中的长视