搜视频号视频

POST

https://api.getoneapi.com/api/wechat-search/fetch_search_video

专搜视频号视频（video 垂类），并支持搜索结果页里的「时长」「不限/最新/最热」排序与「时间」下拉。
等同于综合搜索 /fetch_search（business_type=video）再叠加筛选，筛选项均实测有效。

由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

keyword string 关键词必需

duration integer 可选

可选，默认 all。时长档（video 垂类专属）—— 不限 all/0 / 短(<5min) short/1 / 中(5-10min) medium/2 / 长(20min+) long/3，字符串值或整数均可

sort integer 可选

可选，默认 default。排序 —— 不限(相关性) default/0 / 最新(发布时间降序) latest/1 / 最热(点赞降序) hot/2，字符串值或整数均可

publish_time integer 可选

可选，默认 all。发布时间 —— 不限 all/0 / 最近一天 day/1 / 最近七天 week/2 / 最近半年 half_year/3，字符串值或整数均可

offset integer 可选

可选，默认 0（>=0）。翻页游标。首页传 0；翻页时把上一页响应里返回的 offset 传回（配合 continue_flag 判断是否还有下一页）。

raw boolean 可选

可选，默认 false。true=原始；false=精简解析。

示例

{
  "keyword" : "罗永浩",
  "duration" : 0,
  "sort" : 0,
  "publish_time" : 0,
  "offset" : 0,
  "raw" : false
}

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

{
  "code" : 200,
  "message" : "success",
  "data" : { }
}

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

curl --globoff --request POST 'https://api.getoneapi.com/api/wechat-search/fetch_search_video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "keyword" : "罗永浩",
  "duration" : 0,
  "sort" : 0,
  "publish_time" : 0,
  "offset" : 0,
  "raw" : false
}'

更新于 2026-11-10 19:04:46