帮助文档 > 接口文档 > 《抖音视频作品采集/下载》脚本API接口

《抖音视频作品采集/下载》脚本API接口

2022-12-21 13:54:05 栏目:接口文档 查看(11028)


在此之前请先了解API接口文档介绍运行脚本接口介绍


  • 《抖音视频作品采集》脚本的ScriptPara参数集合中的子参数

参数名

含义

规则说明

是否必须

值实例

NoticeUrl 

通知Url

查询到数据后会通过地址通知服务器

非必填

http://skutl.mz.hccsn.com/api/NoticeTest 

SecretKey
自定义签名密钥自定义签名密钥,最大32位,非必填,如果填了后,通知回调时会多一个签名参数,验签方式请参考通知回调签名验签非必填
abcdefg123456789
queryType
查询类型

传入值为0时:搜索查询抖音平台关键词视频

传入值为1时:批量查询作者所有作品视频

必填
0


  • queryType查询类型为0时需要传入的其他参数

参数名

含义

规则说明

是否必须

值实例

key 

关键词

搜索查询抖音平台关键词视频

必填

服装 

diggStart
点赞数最低值筛选点赞数最低值(int)类型
必填
0
diggEnd
点赞数最高值
筛选点赞数最高值(int)类型
必填
99999999
commentStart
评论数最低值
筛选评论数最低值(int)类型
必填
0
commentEnd
评论数最高值
筛选评论数最高值(int)类型
必填
99999999
collectStart
收藏数最低值
筛选收藏数最低值(int)类型
必填
0
collectEnd
收藏数最高值
筛选收藏数最高值(int)类型
必填
99999999
shareStart
分享数最低值
筛选分享数最低值(int)类型
必填
0
shareEnd
分享数最高值
筛选分享数最高值(int)类型
必填
99999999
startPage
开始页搜索查询的起始页(int)类型必填
0
endPage
结束页搜索查询的结束页;最大100页(int)类型
必填
100
delayed
延时
查询速度延时/毫秒(int)类型
必填
1000


  • queryType查询类型为1时需要传入的其他参数

参数名

含义

规则说明

是否必须

值实例

inputText 

作者主页地址

作者主页地址(PC网页端),可以用\n分割提交多个,最多100个

必填

https://www.douyin.com/user/abcdefg

diggStart
点赞数最低值筛选点赞数最低值(int)类型
必填
0
diggEnd
点赞数最高值
筛选点赞数最高值(int)类型
必填
99999999
commentStart
评论数最低值
筛选评论数最低值(int)类型
必填
0
commentEnd
评论数最高值
筛选评论数最高值(int)类型
必填
99999999
collectStart
收藏数最低值
筛选收藏数最低值(int)类型
必填
0
collectEnd
收藏数最高值
筛选收藏数最高值(int)类型
必填
99999999
shareStart
分享数最低值
筛选分享数最低值(int)类型
必填
0
shareEnd
分享数最高值
筛选分享数最高值(int)类型
必填
99999999
maxPage
最大页每个作者主页最大查询到多少页结束(int)类型必填
100
delayed
延时
查询速度延时/毫秒(int)类型
必填
1000


  • 通知结果

参数名

类型

规则说明

值实例

Code 

int

返回请求状态代码 

1 

Msgstring 
返回请求状态的说明 
ok 
Data 
object 
返回数据集合
{"SoftGuid":"aaaaaaaaa-bbbb-cccc-dddddddddddd","SoftVersion":"5.0.0.0","ItemId":1,"TimeStamp":1671457438,"IsComplete":false,"Data":[......]}


  • 通知结果Data数据集合

参数名

类型

规则说明

值实例

SoftGuid

string

返回请求状态代码 

aaaaaaaaa-bbbb-cccc-dddddddddddd 

SoftVersion
string 
《明智脚本浏览器》软件版本5.0.0.0 
ItemId 
int集合ID,每次通知Url后自动+11
TimeStamp
long软件获取的当前系统时间戳1671457438
Sign
string
运行脚本传入了参数SecretKey自定义密钥时,这个数据参数才会出现,验签方式请参考通知回调签名验签abcdefghigk123456789
IsComplete
bool
是否查询完成false
Data
array查询的结果数组集合[{"awemeId":"123456789","title":"标题","awemeUrl":"https://www.douyin.com/video/123456","diggCount":0,"commentCount":0,"collectCount":0,"shareCount":0,"createTime":"2022-12-17T18:43:46+08:00","nickName":"明智云","authorUrl":"https://www.douyin.com/user/abcd","authorId":"abc123456","playAddr":"http://....."}......]


  • 查询的结果数组Data集合

参数名

类型

规则说明

值实例

awemeId 

string

作品ID 

123456789

title
string
作品标题作品标题 
awemeUrl 
string
作品链接https://www.douyin.com/video/123456
diggCount
int点赞数0
commentCount
int
评论数
0
collectCount
int
收藏数0
shareCount
int
分享数0
createTime
string
作品发布时间2022-12-17T18:43:46+08:00
nickName
string
作者昵称明智云
authorUrl
string
作者主页地址https://www.douyin.com/user/abcd
authorId
string
作者抖音号abc123456
playAddr
string
视频地址http://.....