视频数据查询接口
更新时间：2026-03-20 11:10:36
API测试
申请API调用
基本信息
接口描述：查询抖音、快手、b站等视频数据
请求方式：post
请求地址：
resource/svideo/search
请求参数格式：application/x-www-form-urlencoded
输入参数
参数名称
类型
是否必填
描述
startPubTime
string
是
视频发布时间，表示查询这个时间之后的文章，格式yyyyMMdd或yyyyMMddHHmmss
endPubTime
string
是
视频发布时间，表示查询这个时间之前的文章，格式yyyyMMdd或yyyyMMddHHmmss
medium
string
是
视频平台类型，支持的类型如下：douyin-抖音、kuaishou-快手、bilibili-b站、shipin-视频号、百家号视频-baijia_video、头条号视频-toutiao_video、微博视频-weibo_video(注:查询微博视频时必须指定站点)等，只支持单个平台查询 更多类型示例见数据字典
startLoadTime
string
否
文章入库时间，表示查询这个时间之后的文章，格式yyyyMMdd或yyyyMMddHHmmss
endLoadTime
string
否
文章入库时间，表示查询这个时间之前的文章，格式yyyyMMdd或yyyyMMddHHmmss
screenName
string
否
账号名称，多个名称使用“,”分隔。参数限制：单次查询时数量不超过100个；参数值总长度500个字符以内
searchWordOr
string
否
搜索的关键字，标题或正文中任何一个字段匹配成功都会返回结果，多个关键字使用“,”分隔，多个关键字命中任何一个都会返回结果，输入的关键词总长度100个字符以内。 注意关键词不能包含{、}、“ 等特殊字符
searchWordAnd
string
否
搜索的关键字，标题或正文中任何一个字段匹配成功都会返回结果，多个关键字使用“,”分隔，多个关键字必须同时包含才会返回，输入的关键词总长度100个字符以内。注意关键词不能包含{、}、“ 等特殊字符
mediaAreaCatalog
string
否
媒体所属地域：北京，安徽等，多值使用“,”分隔，多个地域只要命中一个就返回数据，地域查询包含其子地域的数据
minFollowersCount
integer
否
最小粉丝数，用于限制账号范围
maxFollowersCount
integer
否
最大粉丝数，用于限制账号范围
pageNum
integer
否
页码，首页及默认为0
pageSize
integer
否
每页数据，默认20
sortOrder
string
否
结果集排序方式，通过“+”、“-”和数据字段来控制正序或倒序，示例-pubTime表示按照文章发布时间倒叙，支持多字段一起排序，比如【-loadTime,+pubTime】表示先根据入库时间倒序排列，如果时间一致时在根据发布时间正序排序。接口支持的排序字段如下：pubTime(文章发布时间)、loadTime(文章入库时间)、relevance(相关度，只有输入检索词时此参数才有意义，相关度只支持倒序，不支持正序)
输出参数
参数名称
类型
描述
sid
string
视频id，唯一值
title
string
视频标题
pubTime
string
发布时间
screenName
string
账号名称
loadTime
string
入库时间
url
string
视频页面地址
videoUrl
string
视频下载地址
medium
string
视频所属平台
content
string
视频说明
mediaArea
string
媒体地域
videoDuration
string
视频时长
coverPicUrl
string
视频封面图
commentCount
integer
评论数
approveCount
integer
点赞数
playCount
integer
播放量
rttCount
integer
转发/分享数
调用示例
http://[域名]/opens/api/resource/svideo/search?
startPubTime=20221122&endPubTime=20221122&medium=douyin
输入示例
startPubTime=20221122&endPubTime=20221122&medium=douyin
输出示例
{
"code":200,
"msg":"请求成功",
"data":{
"content":[
{
"sid":"6900947731116772612",
"title":"不舍！守边8年退伍战士亲吻界碑。致敬边疆战士，#辛苦了#泪目 #抖音小助手",
"screenName":"甘谷县融媒体中心",
"pubTime":"2021-09-22 13:10:55",
"url":"https://www.amemv.com/share/video/6900947731116772612/?mid=6900947756159470343",
"loadTime":"2021-09-23 02:09:08",
"videoUrl":"https://aweme.snssdk.com/aweme/v1/playwm/?video_id=v0300f470000bv2hen2ibbq4g001j9s0&ratio=720p&line=0",
"medium":"douyin",
"content":"不舍！守边8年退伍战士亲吻界碑。致敬边疆战士，#辛苦了#泪目 #抖音小助手"
}
],
"totalElements":3683,
"totalPages":37,
"number":0,
"size":100,
"numberOfElements":100
},
"requestid":"8762782d-1cf7-11ec-ad94-000af7e86914"
}
接口说明
无
在线测试
请求方式：
POST
*startPubTime：
*endPubTime：
*medium：
startLoadTime：
endLoadTime：
screenName：
searchWordOr：
searchWordAnd：
mediaAreaCatalog：
minFollowersCount：
maxFollowersCount：
pageNum：
pageSize：
sortOrder：
确定
重置
请求结果
错误码
其他错误码详见
公共错误码。