tiktok/
user-playlists

只需用户名,就能列出任意 TikTok 创作者主页上的公开合集,返回每个合集的名称、链接、封面、视频数和所属创作者。

TikTok Playlists API

用户名输入
合集名称
每个合集的视频数
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Playlists

TikTok 合集是创作者把自己的视频整理成的一组组系列,比如分集连载的故事、系列教程或固定栏目,在主页上带有封面和视频数。按用户名列出合集,就能看出一位创作者打包了哪些系列,每个系列里有多少条视频。

TikTok Playlists API 主要特性

  • 主页上的每个公开合集提交用户名,每个公开合集都会作为一条记录返回,数量上限由 results_limit 决定,取值 1 到 100,默认 20。
  • item_count 反映系列的深度item_count 是合集里的视频数,长期更新的系列和只有几条视频的小合集一眼就能区分。
  • 名称、封面和直达链接每条记录都带有 title、cover_url 和合集的 url,author 重复了所有者的 id、账号名和头像,让单条记录自成一体。

TikTok Playlists API 参数

参数必填描述
username必填要列出合集的 TikTok 用户名,开头的 @ 可带可不带。
results_limit可选返回的合集数量,取值 1 到 100,默认 20。

如何使用 TikTok Playlists API

提交用户名,读取创作者的合集。

  1. 向 /v1/tiktok/user-playlists 发送 {"username": "zachking"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取合集;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zachking"}'

# 每条结果是一个合集,包含 title 和 item_count。

TikTok Playlists API 最佳使用场景

  • 对标细分领域的系列形式: 对比同一品类下多位创作者的 title 和 item_count,看他们持续投入哪些系列形式、能把一个系列做多长。
  • 合作前评估达人的内容能力: 在提出分集或长期合作之前,先看对方是否已经把内容整理成系列,以及这些系列做到了多深。

TikTok Playlists API 使用建议

  • 跨多次快照匹配合集时用 id 而不是名称,因为创作者可以给合集改名。
  • 按 item_count 排序,先看更新最久、最长的系列,再去读标题。

除了 TikTok Playlists API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。

  • TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
  • TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
  • TikTok User Videos API — 按 username 采集公开个人资料视频,返回文案、创作者、媒体、时间、互动和来源账号上下文。
  • TikTok Trending Feed API — 按 region 采集当前公开视频动态,返回创作者、文案、封面、时间和可见互动指标。
  • TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。
  • TikTok Reposts API — 按用户名列出账号转发过的视频,包含原作者、文案和播放量。

探索其他平台

还可以将 TikTok 数据与其他已支持社交平台的公开数据结合使用。

TikTok Playlists API — 常见问题

TikTok Playlists API 是一个用于根据用户名列出 TikTok 创作者主页上公开合集的 API。它返回每个合集的 ID、名称、链接、封面、视频数和所属创作者信息。

不能。每条记录描述的是合集本身,item_count 说明里面有多少条视频。要拿创作者的视频,请使用 TikTok User Videos。

不是。合集是创作者在主页上对自己视频的公开分组,这里返回的就是它;收藏夹是个人用来存别人视频的文件夹,不在返回结果里。

因为这位创作者没有公开合集;TikTok 只向符合条件的创作者开放创建合集,所以很多账号都没有。任务仍然成功,不扣积分;每返回一个合集扣 0.5 积分。

过一段时间用同一个用户名再查一次,对比每个合集的 item_count 即可;每条记录的 collected_at 标明了这次快照的时间。