Skip to main content
GET
YouTube 搜索
搜索 YouTube,返回匹配的视频、频道和播放列表。需设置 engine=youtube 并在 q 中传入查询词;两者均为必填。可选地按国家(gl)和界面语言(hl)收窄,或在 sp 中传入 YouTube 筛选 token 以实现分页和上传日期、时长、结果类型等高级筛选。适合用于查找某个话题的视频内容、跟踪某频道的近期上传,或评估某主题的视频覆盖度。 注意:该接口通过 AIsa 映射路径 /apis/v1/youtube/search 提供服务;上游提供商的原生路径并未直接挂载。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

engine
enum<string>
必填

SearchApi 引擎标识符。此 YouTube 端点使用 youtube

可用选项:
youtube
q
string
必填

搜索查询。运行时和上游 SearchApi 必填。

sp
string

YouTube 筛选 token(分页或高级筛选)

gl
string

国家/地区代码(例如 us、jp)

hl
string

界面语言

响应

YouTube 搜索成功响应

SearchApi 通过 AIsa 封装器返回的 YouTube 搜索结果载荷。

search_metadata
object
search_parameters
object
search_information
object
videos
object[]
channels
object[]
shorts
object[]
sections
object[]
playlists
object[]
ads
object[]
pagination
object