找教程视频、盯竞品发了什么新片、看某个技术话题的视频供给变化,视频端点比网页搜索更直接。这篇讲三件事:端点路径(又是单数)、字段口径(title/link 必填、duration/time 全是可选),以及那个容易翻车的 fallback 行为——解析不到视频卡时,解析器会退化成 news 风格提取,你拿到的结果可能没有 duration。参数与字段以 SerpBase 官方文档的视频端点字段表 为准;每次成功请求 1 credit,失败自动退款。端点与字段路径是POST /google/video/search(单数 video,和 image/search 一个路子)。入参四个:q必填,hl/gl/page可选(默认 en/us/1)。VideoResult 里必填的只有rank、title、link;position(rank 别名)、url、source_url、display_url、source、duration、time、published_at、thumbnail_url、thumbnail全是可选。顶层videos数组也是可选的。文档明确写了一条关键行为:“若未解析到专用视频卡,解析器会对兼容的 Google 布局退化为 news 风格提取”。意思是同一个查询,今天返回的是带 duration 的视频卡,明天可能返回一批 news 风格的结果——字段完整度会变。你的解析代码必须按可能没有 duration来写。脚本importcsv,requests APIhttps://api.serpbase.dev/google/video/searchKEY你的 API Keydefvideo_search(q:str,page:int1)-list:resprequests.post(API,headers{X-API-Key:KEY,Content-Type:application/json},json{q:q,hl:zh-CN,gl:cn,page:page},timeout30)dataresp.json()ifdata.get(status)!0:raiseRuntimeError(f{data.get(status)}:{data.get(error)})returndata.get(videos,[])rows[]forkwin[Rust 入门教程,Rust 性能优化]:foriteminvideo_search(kw)[:10]:rows.append({关键词:kw,位次:item[rank],标题:item[title],链接:item[link],时长:item.get(duration,),# fallback 时可能没有来源:item.get(source,),缩略图:item.get(thumbnail_url,),})withopen(videos.csv,w,newline,encodingutf-8-sig)asf:wcsv.DictWriter(f,fieldnames[关键词,位次,标题,链接,时长,来源,缩略图])w.writeheader()w.writerows(rows)print(f共{len(rows)}条 → videos.csv)三条实战经验把 fallback 当成常态,不是异常。查询词偏新闻态(比如某产品 发布)时,退化提取的概率天然更高。脚本里 duration 一律.get()兜底;做视频供给监控这类统计时,把有时长字段的条数单独记一列,条数对不上时先看这一列,别急着下视频变少了的结论。去重键用 link,别用 title。同一支视频在不同 query、不同 page 下 title 可能带不同的站点后缀,link 才是稳定标识;跨关键词汇总时按 link 去重。thumbnail 不能直接当封面用。thumbnail_url是 Google 暴露的缩略图地址,和图片端点一样有防盗链和可达性问题;落库时记下来,展示层建议先 HEAD 校验再决定是否代理下载。成本每关键词每次请求 1 credit,10 个关键词一轮 10 credits。视频结果比网页结果稳定得多,同一个 (q, hl, gl, page) 短期内不会变,按四元组缓存能省掉大部分重复请求。按 $10/20k 的标准包算,一轮成本半分钱。FAQvideos 数组会不存在吗?会。它是可选的——当解析到视频结果时才有;零结果时可能整个键缺失,所以用data.get(videos, [])。fallback 返回的结果还是视频吗?是 news 风格提取的结果,可能没有 duration 这类视频专属字段;判断是否退化批次看 duration 填充率最直观。有 device 参数吗?没有,device 只属于搜索端点;视频端点入参就是 q/hl/gl/page。time 字段能精确过滤吗?它是原始发布时间文本,可选且格式不保证;趋势统计按月聚合可以,别做精确时间窗过滤。把关键词换成你的监测对象,先跑一轮看 duration 在你这个领域的填充率,再决定统计口径怎么定。