Google 视频搜索
Google 视频 SERP，支持视频检索、时间过滤和地区定向参数。
本页给出 Google 视频搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | Google 视频搜索 |
| 原始名称 | Google Video Search |
| 内部标识（scraper） | google_video |
| 接口标识（engine） | google_video |
| 网站 | |
| 网站地址 | googlevideo.com |
| 输出格式 | json |
| 版本 | 1.0.0 |
| 参数数量 | 14 |
| 参数分组 | 搜索词 (1), 地区与语言 (4), 分页 (2), 高级筛选 (4), 地理位置 (2), 请求控制 (1) |
必填参数
以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。
| 参数 | 类型 | 分组 | 说明 |
|---|---|---|---|
q | string | 搜索词 | 你想让搜索引擎检索的关键词或短语。 |
可用参数
以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。
搜索词
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 你想让搜索引擎检索的关键词或短语。 |
地区与语言
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
gl | string | 否 | 用于本地化搜索结果的国家或地区代码。 |
hl | string | 否 | 用于控制搜索界面和结果标签语言的参数。 |
lr | string | 否 | 将结果限制在一个或多个语言范围内。 |
google_domain | string | 否 | 要请求的 Google 域名，例如 google.com 或 google.co.uk。 |
附加约束
gl：默认值：us；可选值：244 个可选值，例如：af、al、dz、as、adhl：默认值：en；可选值：157 个可选值，例如：af、ak、sq、ws、amgoogle_domain：默认值：google.com；可选值：47 个可选值，例如：google.com、google.com.hk、google.co.uk、google.co.jp、google.us
分页
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
num | number | 否 | 希望返回的结果数量。 |
start | number | 否 | Google 风格分页使用的结果偏移量。 |
附加约束
num：默认值：0start：默认值：0
高级筛选
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tbs | string | 否 | Google 的高级筛选字符串，常用于时间或内容过滤。 |
nfpr | boolean | 否 | 尽量关闭自动纠错结果，优先保留原始查询词。 |
safe | number | 否 | 用于控制成人内容过滤级别的安全搜索参数。 |
filter | boolean | 否 | 控制是否启用相似结果或重复结果过滤。 |
附加约束
nfpr：默认值：falsesafe：默认值：1；可选值：2 个可选值，例如：1、2filter：默认值：false
地理位置
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uule | string | 否 | Google 使用的编码位置字符串，可用于更精细的地理定向。 |
location | string | 否 | 用于让结果更贴近目标地区的地理位置提示。 |
附加约束
location：默认值：US；可选值：10 个可选值，例如：IN、US、BR、ID、MX
请求控制
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
no_cache | boolean | 否 | 跳过缓存结果并强制重新抓取。 |
附加约束
no_cache：默认值：false