logo

TikTok 关键词视频搜索

给一个搜索关键词，返回匹配的视频链接与视频编号列表

数据获取社交媒体TikTok视频

概览

想在 TikTok 上摸清某个品类或品牌有哪些相关视频在传播？给一个搜索关键词，任务在后台完成后，你会拿到一份匹配视频清单，每条带视频链接与视频编号，可以直接筛候选内容或交给详情类分析继续深挖。

比起在 TikTok 搜索页手工翻页、逐条复制链接，它把关键词下的匹配视频一次拉成结构化列表，同一视频编号只出现一次，适合当作选品初筛、话题监测和竞品内容摸底的入口数据。

数据说明

清单取自 TikTok 公开搜索/列表结果，按本次提交的关键词匹配返回，每个视频编号只出现一次。视频链接与编号是取数当时可访问的公开地址；排序与相关度由平台算法决定，不保证与 App 内搜索页完全一致。仅覆盖公开可见视频，私密、已删除或地区不可见的视频不在其中。单次任务只支持一个关键词，实际返回条数不超过你设定的「最多采集条数」。

结果长什么样

每条记录是一条匹配视频：

视频编号视频链接匹配关键词关键词类型采集时间
7677749073868328206https://www.tiktok.com/@annexwong/video/7677749073868328206Shokzkeyword2026-08-25T10:22:47

另有「提交关键词」「无数据」等字段。

应用场景

  • 做选品初筛时，用「视频链接」清单导出候选视频，再按播放量等维度做二次筛选。
  • 做品牌监测时，对固定「提交关键词」定期跑任务，比对新增「视频编号」看谁新发布了相关内容。
  • 做话题研究时，换不同「搜索关键词」各跑一遍，比较各词下返回视频的规模与重叠度。
  • 搭建分析流水线时，把「视频编号」或「视频链接」交给视频详情或评论类 App，补齐互动与评论数据。

适用边界

单次仅支持一个关键词；返回视频条数由「最多采集条数」控制，默认 50 条、上限 500 条。

  • 适合用于
  • 需要按关键词获取 TikTok 上相关视频清单时
  • 选品或竞品监测时需要先捞一批候选视频链接，再交给详情或评论类 App 深挖时
  • 不要用于
  • 已有明确视频链接、只需单条视频详情时——用视频详情类 App
  • 需要一次提交多个不同关键词时——本 App 单次仅支持一个关键词

失败处理

作者声明的失败与重试处理方式，接入时建议一并写进系统提示词。

  1. 1任务失败或过期可原样重新提交
  2. 2关键词过于生僻或暂无匹配结果时可能返回空列表，可换更通用的品类词重试
  3. 3鉴权失败属不可重试错误，需先配置有效 API 密钥

输入参数

调用本 App 需要传入的参数，与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
keyword搜索关键词string是——Shokz要在 TikTok 上搜索的关键词或品牌词，建议用品类词、品牌词或标签词，不要写整句自然语言，最长 512 字符
max_results最多采集条数integer否501–500—本次任务最多采集多少条匹配视频，不填默认 50 条；值越大耗时和费用越高

输出数据

单条记录的字段结构，与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
content_id视频编号string—匹配视频在平台内的唯一编号
content_url视频链接string—匹配视频的页面 URL
keyword匹配关键词string—本条结果关联的搜索关键词
keyword_type关键词类型string—关键词匹配类型标识
crawl_time采集时间string—本条结果被采集的时间
biz_id业务标识string—接口返回的业务标识，原始记录未提供时为空
cur_id记录标识string—本条采集结果的记录标识，原始记录未提供时为空
submitted_keyword提交关键词string—本次任务提交时填写的搜索关键词
no_data无数据boolean—该关键词是否未采集到有效匹配结果

记录 Schema

输出按记录逐条返回。记录主键为 content_id，去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "视频编号",
      "description": "匹配视频在平台内的唯一编号"
    },
    "content_url": {
      "type": "string",
      "title": "视频链接",
      "description": "匹配视频的页面 URL"
    },
    "keyword": {
      "type": "string",
      "title": "匹配关键词",
      "description": "本条结果关联的搜索关键词"
    },
    "keyword_type": {
      "type": "string",
      "title": "关键词类型",
      "description": "关键词匹配类型标识"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "本条结果被采集的时间"
    },
    "biz_id": {
      "type": "string",
      "title": "业务标识",
      "description": "接口返回的业务标识，原始记录未提供时为空"
    },
    "cur_id": {
      "type": "string",
      "title": "记录标识",
      "description": "本条采集结果的记录标识，原始记录未提供时为空"
    },
    "submitted_keyword": {
      "type": "string",
      "title": "提交关键词",
      "description": "本次任务提交时填写的搜索关键词"
    },
    "no_data": {
      "type": "boolean",
      "title": "无数据",
      "description": "该关键词是否未采集到有效匹配结果"
    }
  },
  "required": [],
  "additionalProperties": false
}

调用方式

本 App 支持通过 MCP、API、SDK 与文件导出方式接入，各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证，凭证为 API Key（长期有效，在开放平台创建）；MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。

通过 MCP（Model Context Protocol）协议，可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式，复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可，各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "SpiderKing999__tiktok-keyword-search": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/tiktok-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
查看我的 API Keys →

让 AI 自己完成配置

不想手动改配置？复制安装提示词，粘贴到任意 AI 客户端对话框，由它按自身方式完成接入（提示词会让 AI 向你索要 API Key，避免凭证留在对话记录或共享配置里）。

如需在同一个 MCP 连接里指定多个 App，前往 MCP 连接页（已为你指定本 App）。

价格

提交一次关键词搜索

每提交一次任务计费一次，与返回条数无关。

¥0.05/ 次
返回一条视频

按实际成功返回的数据条数计费，任务失败不计费。每 10 条为一个计费单位，不足 10 条按 10 条计。

¥0.006/ 10 条

多个计费事件按各自口径独立累计，具体以每一项说明为准；任务失败不计费。

查看余额

立即体验

填写参数直接运行，结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.006 / 10 条起