OpenAPI
搜索视频（跨平台）
搜索视频（跨平台）
/v1/videos/search- 认证方式
- X-API-Key
- 所需 scope
video:search- 计费
- 价格以账户生效规则为准
- 限流
- 查看当前限流规则
请求参数
该请求使用 JSON 请求体提交。
platformstring必填平台：tiktok / youtube / instagram（必填）
query_typestring可选达人标识符类型：union_user_id（默认，达人唯一ID）/ kol_page_url（达人主页URL）/ user_name（用户名）
默认值: "union_user_id"
union_user_id · kol_page_url · user_name
union_user_idsarray可选达人标识符列表，具体含义由 query_type 决定（可选筛选条件）
展开字段
该接口暂不提供 Schema 详情。
hashtagarray可选Hashtag 列表（精确匹配，最多 5 个）
展开字段
该接口暂不提供 Schema 详情。
video_titlestring可选视频标题关键词（模糊匹配）
video_views_cnt_gteinteger可选最小播放量
0 ≤ video_views_cnt_gte ≤ 1000000000
video_views_cnt_lteinteger可选最大播放量
0 ≤ video_views_cnt_lte ≤ 1000000000
video_interaction_rate_gtenumber可选最小互动率（百分比，如 5.5 表示 5.5%）
0 ≤ video_interaction_rate_gte ≤ 100
video_interaction_rate_ltenumber可选最大互动率（百分比，如 5.5 表示 5.5%）
0 ≤ video_interaction_rate_lte ≤ 100
video_publish_date_gtestring可选发布日期起始（格式：YYYY-MM-DD，不传则不按发布日期筛选）
video_publish_date_ltestring可选发布日期截止（格式：YYYY-MM-DD）
pageinteger可选页码（1-10）
默认值: 1
1 ≤ page ≤ 10
sizeinteger可选每页数量（固定 10）
默认值: 10
1 ≤ size ≤ 10
响应
successboolean必填dataarray可选展开字段
该接口暂不提供 Schema 详情。
errorobject可选错误详情
展开字段
codeinteger必填业务错误码
messagestring必填可读错误信息
metaobject可选响应元数据
展开字段
request_idstring可选请求唯一标识
默认值: ""
pageinteger可选当前页码
sizeinteger可选每页数量
totalinteger可选总数
quota_remaininginteger可选剩余配额（-1 表示不限制）
默认值: -1
service_levelstring可选本次请求的服务等级
langstring可选响应语言（cn/en），为空表示未翻译
platformstring可选本次请求的达人平台
recall_typestring可选召回类型：hybrid / vector / scalar
credits_consumedinteger可选本次请求扣减的积分数
默认值: 0
credits_remaininginteger可选积分余额（-1 不限制）
默认值: -1
billable_unitsinteger可选Server-calculated billable units for this response
默认值: 0
0 ≤ billable_units ≤ ∞
skill_namestring可选调用方 skill 名称
skill_current_versionstring可选调用方 skill 当前版本
skill_latest_versionstring可选服务端声明的最新 skill 版本
skill_min_supported_versionstring可选服务端声明的最低支持版本
skill_update_availableboolean可选是否存在可用 skill 更新
默认值: false
skill_update_requiredboolean可选是否要求更新 skill 后再继续使用
默认值: false
skill_update_messagestring可选skill 更新提示文案
skill_update_manifest_urlstring可选skill 更新 manifest URL