跳转到主要内容
GET
cURL
🪙3 credits每次请求

Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词,可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

授权

Authorization
string
header
必填

接口鉴权凭证。请在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。 可在 Dashboard 获取你的 API Key。

查询参数

search_query
string
必填

搜索关键字,用于匹配Shorts视频的标题、描述等内容

language_code
string
默认值:en-US

设置搜索结果的显示语言,影响返回内容的语言偏好 ,默认值:en-US 影响:会影响搜索算法的语言匹配和结果排序)

可选值: "zh-CN", "en-US", "ja-JP", "ko-KR" 及其他符合IETF BCP 47标准的语言代码

country_code
string
默认值:US

设置地区/国家代码,影响搜索结果的地域相关性和内容可用性,默认值:US(某些Shorts可能因地区限制而不可见)

可选值:US、CN、JP、KR、GB、DE、FR、CA 及其他符合ISO 3166-1 alpha-2标准的国家代码

time_zone
string
默认值:America/Los_Angeles

设置时区,影响时间相关过滤器(如"今天"、"本周")的计算,默认值:America/Los_Angeles 影响:结合upload_time参数使用时,决定"今天"等时间段的具体范围

可选值:符合IANA时区数据库的时区标识符 "America/Los_Angeles" - 美国太平洋时区 "America/New_York" - 美国东部时区 "Asia/Shanghai" - 中国时区 "Asia/Tokyo" - 日本时区 "Europe/London" - 英国时区 "Europe/Paris" - 法国时区

filter_mixed_content
boolean
默认值:true

控制是否自动过滤掉响应中的长视频(非Shorts内容),默认值: true true - 自动过滤长视频,只返回Shorts(推荐) false - 返回原始内容,可能包含长视频

使用场景: true: 当你只需要纯Shorts内容时使用(推荐首次请求使用) false: 当你需要分析YouTube原始返回的混合内容时使用(调试用) 注意: 只影响首次请求,使用continuation_token的请求本身就只返回Shorts

upload_time
string

按上传时间过滤Shorts,只返回指定时间段内上传的视频,默认值: null (不过滤) 可选值 hour : 过去1小时内上传 today: 今天上传(基于time_zone参数) week: 本周上传(最近7天) month: 本月上传(最近30天) year: 今年上传(最近365天)

使用场景: 寻找最新、热门的Shorts内容 注意: 与time_zone参数配合使用,时间计算基于设定的时区

sort_by
string

设置搜索结果的排序方式,默认值: null (YouTube默认相关性排序) 可选值 relevance: 按相关性排序(YouTube默认算法) upload_date: 按上传日期排序(最新优先) view_count: 按观看次数排序(最多观看优先) rating: 按评分排序(最高评分优先)

使用场景: relevance: 寻找最相关的内容 upload_date: 寻找最新发布的Shorts view_count: 寻找最受欢迎的Shorts rating: 寻找质量最高的Shorts 优先级: sort_by的优先级高于upload_time,两者同时使用时以sort_by为准

continuation_token
string

用于获取下一页搜索结果的翻页令牌,默认值: null (获取第一页) 获取方式: 从上一次请求的响应中提取(见"翻页机制详解"部分) 注意: Token有时效性,通常在数小时内有效 使用continuation_token时,必须保持search_query等其他参数一致 使用token的请求会自动返回纯Shorts内容(无需过滤)

使用场景: 首次搜索:不传此参数,获取第一页结果 后续翻页:传入上次返回的token,获取下一页结果

响应

请求成功

The response is of type object.