使用 JustOneAPI 调用 GET /api/douyin/search-video/v4,按关键词搜索抖音(TikTok中国)视频。
Douyin (TikTok China) 视频搜索是一项面向实际任务的技能,主要用于将这个聚焦的 JustOneAPI 技能用于 Douyin (TikTok China) 视频搜索;它的目标为 Get / api/douyin/search-video/v4;
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
使用此聚焦型 JustOneAPI 技能执行抖音(TikTok 中国版)视频搜索。该技能对接 GET /api/douyin/search-video/v4 接口。必需的非 token 输入参数为 keyword。OpenAPI 描述为:获取抖音(TikTok 中国版)视频搜索数据,包括元数据与互动信号,用于内容发现、趋势研究及竞品监控。
douyinsearch-videojustoneapi-douyin-search-video| 操作 | 版本 | 方法 | 路径 | OpenAPI 摘要 |
|---|---|---|---|---|
searchVideoV4 |
v4 |
GET |
/api/douyin/search-video/v4 |
视频搜索 |
| 参数 | 位置 | 所有调用必需 | 可选 | 类型 | 说明 |
|---|---|---|---|---|---|
duration |
query |
n/a | all | string |
按视频时长筛选。可选值:- _0:不限 - _1:1 分钟以内 - _2:1–5 分钟 - _3:5 分钟以上 |
duration 枚举值 |
取值 | n/a | n/a | n/a | _0、_1、_2、_3 |
keyword |
query |
all | n/a | string |
搜索关键词 |
page |
query |
n/a | all | integer |
页码(从 1 开始) |
publishTime |
query |
n/a | all | string |
按视频发布时间范围筛选。可选值:- _0:不限 - _1:最近 24 小时 - _7:最近 7 天 - _180:最近 6 个月 |
publishTime 枚举值 |
取值 | n/a | n/a | n/a | _0、_1、_180、_7 |
searchId |
query |
n/a | all | string |
搜索 ID;当请求页码大于 1 时为必需(请使用上一次响应中返回的 search_id 值) |
sortType |
query |
n/a | all | string |
搜索结果排序依据。可选值:- _0:综合排序 - _1:点赞数更高 - _2:最新发布 |
sortType 枚举值 |
取值 | n/a | n/a | n/a | _0、_1、_2 |
请求体:无文档定义;所有参数均通过路径或查询参数传递。
请使用 searchVideoV4 调用已文档化的 v4 接口。本技能中不包含其他版本。
本技能支持的操作 ID:searchVideoV4。
node {baseDir}/bin/run.mjs --operation "searchVideoV4" --token "$JUST_ONE_API_TOKEN" --params-json '{"keyword":""}'
在调用辅助函数前,请先向用户确认所有缺失的必需参数。用户提供的 ID、游标(cursor)、关键词及筛选条件须保持原样,不得修改。
JUST_ONE_API_TOKEN--token "$JUST_ONE_API_TOKEN" 传入 token;切勿将 token 值粘贴至聊天消息、截图或日志中。searchVideoV4 对应 /api/douyin/search-video/v4。keyword)。相关专题
热门下载
相关下载
精品课程
共6课时 | 54.6万人学习
共89课时 | 133.4万人学习
共49课时 | 82.2万人学习