Yahoo 视频搜索

Yahoo 视频 SERP，支持视频检索以及时长、时间、分辨率、来源等过滤参数。

本页给出 Yahoo 视频搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Yahoo 视频搜索
原始名称	Yahoo Video Search
内部标识（scraper）	`yahoo_video`
接口标识（engine）	`yahoo_video`
网站	Yahoo
网站地址	Yahoo.com
输出格式	`json`
版本	`1.0.0`
参数数量	`7`
参数分组	分页 (1), 搜索词 (1), 高级筛选 (4), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 yahoo_video 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"yahoo_video","b":1,"q":"360 camera"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:16:53 UTC",
    "id": "01KMMKF761VJ4Q5X3NBEBAQBZJ",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKF761VJ4Q5X3NBEBAQBZJ.json",
    "processed_at": "2026-03-26 08:16:53 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKF761VJ4Q5X3NBEBAQBZJ.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "b": 1,
    "engine": "yahoo_video",
    "q": "360 camera"
  },
  "total_credits_used": 1,
  "related_searches": [
    {
      "link": "https://video.search.yahoo.com/search/video;_ylt=AwrEtnJx68RpLj4Ahub7w8QF;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3JlbA--?&p=360+Camera+Review&fr2=p%3As%2Cv%3Av%2Cm%3Ars-top%2Cct%3ArelatedSearches",
      "position": 1,
      "serpapi_link": "https://serpapi.com/search.json?device=desktop&engine=yahoo_videos&p=360+Camera+Review",
      "thumbnail": "https://tse1.mm.bing.net/th?q=360+Camera+Review&pid=Api&mkt=en-US&cc=US&setlang=en&adlt=strict&t=1",
      "title": "360 camera Review"
    },
    {
      "_note": "14 more items omitted"
    }
  ],
  "videos_results": [
    {
      "date": "",
      "duration": "11:01",
      "extracted_views": 145900,
      "link": "https://video.search.yahoo.com/search/video;_ylt=AwrEtnJx68RpLj4Auub7w8QF;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Ny?p=360+camera&imgurl=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D3m055_OjDzg",
      "original": "https://www.youtube.com/watch?v=3m055_OjDzg",
      "position": 1,
      "source": "The NEW Insta360 X4 has arrived - 8K video, 5.7K 60 FPS, Longer Battery, Faster AI chip & New Modes - starting at $499! BUY 8K Insta360 X4: https://bit.ly/4aOIpCW First 10 orders get 15% OFF + 1 x free invisible selfie s... [truncated, 348 chars]",
      "thumbnail": "https://tse4.mm.bing.net/th/id/OVP.ciUe-iSn3pIPwlgEwdJamgHgFo?pid=Api&h=360&w=480&c=7&rs=1",
      "title": "Insta360 X4 Real World Test - ULTIMATE 8K 360 Action Camera !",
      "views": "145.9K views"
    },
    {
      "_note": "59 more items omitted"
    }
  ]
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
`b`	`number`	分页	Yahoo 风格分页使用的结果偏移量。
`q`	`string`	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

分页

参数	类型	必填	说明
`b`	`number`	是	Yahoo 风格分页使用的结果偏移量。

附加约束

b：默认值：1

搜索词

参数	类型	必填	说明
`q`	`string`	是	你想让搜索引擎检索的关键词或短语。

高级筛选

参数	类型	必填	说明
`durs`	`string`	否	Length 参数。
`vage`	`string`	否	Date 参数。
`vres`	`string`	否	Resolution 参数。
`vsite`	`string`	否	Source 参数。

附加约束

durs：可选值：3 个可选值，例如：short、medium、long
vage：可选值：4 个可选值，例如：day、week、month、year
vres：可选值：4 个可选值，例如：360p、480p、720p、1080p
vsite：可选值：8 个可选值，例如：youtube、dailymotion、vimeo、mtv、cbsnews

请求控制

参数	类型	必填	说明
`device`	`string`	否	请求结果时使用的设备类型，例如桌面端或平板端。

附加约束

device：可选值：1 个可选值，例如：desktop

引擎列表

Yahoo 视频搜索