概览
TikTok 用户的视频列表可以帮助你快速了解账号的内容主题、更新节奏和公开内容沉淀。这个 App 按用户名采集公开视频记录,并按采集时间顺序整理成适合分析和留存的内容清单。
相比逐条浏览账号主页,这份列表更适合建立账号内容底表、保存采集快照,并在多次采集后对比内容变化。
数据说明
数据取自指定 TikTok 用户在采集时公开可见的视频内容。内容编号用于识别同一视频,用户名与用户名类型用于标识采集来源,采集时间记录本次采集到该内容的时间。结果按采集时间正序返回;公开内容数量不足、内容不可见或账号没有公开视频时,返回数量可能少于期望值,并保留无数据标记。私密、已删除、受限或登录后可见的视频不在结果中。
结果长什么样
每条正常记录代表指定 TikTok 用户的一条公开视频:
| 内容编号 | 用户名 | 用户名类型 | 采集时间 | 任务项 | 是否无数据 |
|---|---|---|---|---|---|
| 7684177072012430612 | Shokz | account | 2026-09-21T12:03:12 | snaikseven | false |
此外还会提供内容来源标识,便于将多次任务或多个账号的结果进行归并。
应用场景
- 做账号内容盘点时,按「用户名」或「任务项」汇总「内容编号」,建立账号的视频资产清单。
- 研究更新节奏时,结合「采集时间」观察账号公开视频的持续产出情况。
- 做公开内容监测时,对比不同时间采集的结果,发现内容新增或公开状态变化。
适用边界
单次任务处理 1 个 TikTok 用户名,最多采集 100 页、每页 35 条视频(最多 3500 条);仅覆盖公开可见内容。
- 适合用于
- 需要按 TikTok 用户名获取该用户公开视频列表时
- 需要按采集时间顺序整理 TikTok 用户视频内容编号和采集时间时
- 不要用于
- 只需要 TikTok 用户主页资料而不需要视频列表时——本 App 返回视频记录
- 需要私密、已删除、受限或登录后可见内容时——本 App 仅覆盖公开可见内容
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回无数据标记时可核对 TikTok 用户名,或确认该用户是否有公开可见视频
- 2任务仍在采集时不要把空页当作完成,应结合任务状态判断
- 3限流、服务暂不可用或请求超时可稍后使用相同输入重试
- 4任务提交结果不明时不要连续重复提交,避免产生重复任务
- 5鉴权失败需先检查执行环境中的 API Key 配置
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- TikTok 用户名
account必填string要采集的 TikTok 用户名,每次任务只处理一个;长度不得超过 512 个字符示例snaikseven - 期望采集数量
crawl_num必填integer本次任务期望采集的视频数量,取值 1–3500;按每页 35 条、最多 100 页采集,实际返回数量可能受公开内容数量影响范围1–3500示例35
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 内容编号
content_idstringTikTok 视频内容的唯一标识示例7684177072012430612 - 采集时间
crawl_timestring本条视频被采集的时间示例2026-09-21T12:03:12 - 用户名
keywordstring本条视频对应的 TikTok 用户名示例Shokz - 用户名类型
keyword_typestring采集来源的类型;账号采集时为 account示例account
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"content_id": "7684177072012430612",
"crawl_time": "2026-09-21T12:03:12",
"keyword": "Shokz",
"keyword_type": "account",
"source_item": "snaikseven",
"no_data": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/tiktok-account-video-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。每 35 条为一个计费单位,不足 35 条按 35 条计。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。