SerpBase

Google Videos Search — API 参考文档

POST
可调用
/google/videos/search

视频搜索

按查询搜索 Google 视频条目；不提供视频下载或去水印服务。

type
videos
result
videos
计费
1 点

按查询搜索 Google 视频条目；不提供视频下载或去水印服务。

参数
q
必填
string

必填

搜索查询字符串。

hl
可选
string

可选

语言代码，默认 en。

gl
可选
string

可选

国家代码，默认 us。

page
可选
number

可选

从 1 开始的页码，默认 1。

query
示例
string

目录示例；必填规则由接口校验。

示例: "how espresso machines work"

json
{
  "query": "how espresso machines work"
}
在 Playground 中调用
响应字段
query
必填
string

必填

请求中的标准化 query。

page
必填
number

必填

当前页码，从 1 开始。

videos
可选
VideoResult[]

解析到视频结果时返回。

Google 视频结果。

VideoResult 结果项字段
rank
必填
number

必填

当前响应里的 1-based 排名。

position
可选
number

可用时作为 rank 的别名。

给客户端使用的标准化排名别名。

title
必填
string

必填

结果标题。

link
必填
string

必填

parser 返回的主链接。

url
可选
string

结果链接可归一化时返回。

规范化目标 URL，通常和 link 相同。

source_url
可选
string

只有观测到 Google 跳转/来源 URL 时返回。

保留的原始 Google URL，用于调试和溯源。

display_url
可选
string

当 Google 展示文本或域名可解析时返回。

展示 URL 或来源域名。

source
可选
string

解析到来源或频道时返回。

视频来源或频道。

duration
可选
string

结果文本包含时长时返回。

视频时长文本。

time
可选
string

解析到发布时间时返回。

原始发布时间文本。

published_at
可选
string

解析到 time 时返回的时间别名。

标准化发布时间别名。

thumbnail_url
可选
string

Google 暴露缩略图时返回。

缩略图 URL。

thumbnail
可选
string

可用时作为 thumbnail_url 的别名。

标准化缩略图别名。

代码与响应示例
bash
curl -X POST 'https://api.serpbase.dev/google/videos/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"how espresso machines work"}'
现有 Google 请求示例
bash
curl -X POST https://api.serpbase.dev/google/videos/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio tutorial",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
说明

视频搜索、教程发现、媒体监控。

如果没有解析到专用视频卡片，parser 会对兼容的 Google 布局回退到 news 风格提取。