Video Search

Video Search（视频搜索）

概述

跨平台（TikTok、YouTube、Instagram）短视频搜索，支持基于 Hashtag、视频标题、播放量、互动率、发布日期等多维度筛选，结果即时返回。不传 platform 时可跨平台搜索。

与达人搜索的区别：视频搜索直接返回视频维度的数据（含视频指标 + 发布达人信息），适合“找某个话题下的爆款视频”“按播放量筛选热门视频”等场景。如需搜索达人本人信息，使用 creator-search 子 skill。

脚本引用

调用格式：

node {baseDir}/scripts/search_videos.mjs '{"platform":"tiktok","hashtag":["beauty","skincare"],"video_views_cnt_gte":100000,"page":1,"size":10}'

品牌视频洞察检索（复用关键词监控的 hashtag 扩展逻辑，只查已有视频库，不自动触发实时采集）：

node {baseDir}/scripts/search_brand_video_insights.mjs '{"brand_name":"Fenty Beauty","platforms":["tiktok"],"limit":20}'

品牌视频洞察展示规则

当调用 search_brand_video_insights.mjs 时，不要直接把原始 JSON 丢给用户。必须按下面结构展示：

1. 先说明这是“已有视频库检索”，并明确没有自动触发实时采集。
2. 展示 keyword_expansion.used_hashtags，让用户知道品牌名被扩展成了哪些检索词。
3. 展示 summary：命中视频数、平台分布、热门标签、高频达人。
4. 用视频表格展示 items，推荐字段为：#、平台、视频标题、匹配词、播放量、点赞、评论、互动率、达人、发布时间、视频链接。
5. 表格下方给 1-3 条业务判断，例如品牌内容集中在哪些场景、哪些标签更热、哪些达人值得继续看。
6. 如果 items 为空，只说明已有视频库未命中，不要静默切换普通视频搜索、网页搜索或实时采集；需要继续采集时先询问用户确认。

推荐展示模板：

已在已有视频库中检索 {brand_name} 相关视频，未触发实时采集。

扩展检索词：{used_hashtags}

命中概览：
- 命中视频：{video_count} 条
- 平台分布：{platform_distribution}
- 热门标签：{top_hashtags}
- 高频达人：{top_creators}

| # | 平台 | 视频标题 | 匹配词 | 播放量 | 点赞 | 评论 | 互动率 | 达人 | 发布时间 | 视频 |
|---|---|---|---|---:|---:|---:|---:|---|---|---|

参数说明

所有参数均为可选（POST JSON Body 发送到后端），无必填参数，不传则返回最近 15 天的全平台热门视频。

参数提取规则

1. platform 必须转换为小写：tiktok / youtube / instagram。
2. hashtag 必须是 JSON 字符串数组，如 ["beauty"]，不要传单个字符串。
3. 互动率传 0~100 的百分比数值：用户说“互动率至少 5%”时传 5，不能传 0.05。
4. 日期格式统一传 YYYY-MM-DD。
5. 后端默认行为：video_publish_date_gte 和 video_publish_date_lte 都不传时，默认最近 15 天。

参数传递强制规则（NOT Pass）

• [NOT] service_level 参数：视频搜索不使用分级计费。
• [NOT] keyword / industry / gender / country_code 等达人筛选参数：这些属于 creator-search。
• [NOT] sort_field / sort_order：视频搜索暂不支持自定义排序。

返回字段

示例

按 Hashtag 搜索 TikTok 视频

{"platform":"tiktok","hashtag":["beauty"],"page":1,"size":10}

跨平台搜索高播放量视频

{"video_views_cnt_gte":1000000,"page":1,"size":10}

按标题关键词 + 互动率筛选

{"platform":"youtube","video_title":"skincare routine","video_interaction_rate_gte":5,"page":1,"size":10}

按达人 ID 搜索其近期视频

{"union_user_ids":"7480117868423119918,7158794701745964074","page":1,"size":10}

输出格式

| # | 平台 | 视频标题 | 播放量 | 点赞 | 评论 | 互动率 | 达人 | 发布日期 | 视频链接 |

格式规则

• 仅展示实际返回的非空字段。
• 表格内链接用 [查看][linkN] 引用式，表格下方定义完整 URL。
• 统计信息单独列出：总匹配数、消耗积分、剩余配额、请求 ID。

积分消耗

视频搜索按次计费，与搜索结果条数无关。具体积分单价由后端 @openapi_billing() 决定（通常为数 credits/次）。

错误处理