douyin/
user-videos

通过抖音主页 URL 或已知 user_id 获取最多 20 条公开视频,返回标准化内容、作者、媒体、时长、时间与可见互动数据。

Douyin User Videos API

主页 URL 或 user_id
最多 20 条视频
标准化视频记录
每次请求 0.1 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Douyin User Videos

此 endpoint 将一个抖音创作者标识转换为单个来源页中的公开视频记录。结果可包含文案、作者上下文、来源 URL、发布与采集时间、媒体、时长,以及来源提供的播放、点赞、评论、分享或浏览计数。

Douyin User Videos API 主要特性

  • 两种创作者定位方式可提交受支持的抖音主页 URL,也可直接提交已知 user_id;同时填写时,backend 优先使用 user_id。
  • 清晰的一页范围results_limit 可在 1 至 20 之间选择,默认与最大值均为 20;provider 请求始终从首个来源页开始。
  • 内容与作者信息同一结构返回每条 reel-video 记录统一保留可用文案、公开作者字段、来源 URL、时间、媒体引用和视频时长。
  • 适合留存的互动观察值将可获得的播放、点赞、评论、分享和浏览数与 collected_at 一并返回,明确每次观察发生的时间。

Douyin User Videos API 参数

参数必填描述
url必填(至少一项)抖音主页引用,hostname 必须是 douyin.com、iesdouyin.com 或其子域名,且路径包含 /user/{identifier}。url 与 user_id 至少填写一个;同时提供时使用 user_id。
user_id必填(至少一项)已知用户标识,长度为 1 至 256,仅可包含 ASCII 字母、数字、冒号、下划线或连字符。需与 url 至少填写一个。
results_limit可选单个 provider 来源页期望返回的记录数。仅接受 1 至 20 的整数,默认值为 20。

如何使用 Douyin User Videos API

提交一个公开创作者标识,等待异步任务完成,再读取已存储的标准化视频结果。

  1. 准备 douyin.com 或 iesdouyin.com 上路径包含 /user/{identifier} 的主页 URL,或者一个已知 user_id。
  2. 向 /v1/douyin/user-videos POST 标识及可选的 1 至 20 results_limit,并保存 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或失败。
  4. 读取 data.results.items;只有 SocQ 已存储记录仍有下一页时才继续使用 next_cursor,它不会请求新的来源页。
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;next_cursor 仅用于已存储结果

Douyin User Videos API 最佳使用场景

  • 创作者视频快照: 在指定观察时点保存一个范围受限的公开视频集合,并保留每条记录的采集时间。
  • 视频目录补全: 为已有创作者记录补充标准化文案、作者身份、来源 URL、发布时间、时长和可用媒体。
  • 创意与格式整理: 依据返回的文案、时长和媒体字段,对现有视频的内容呈现或格式做结构化归类。
  • 同次快照内的互动比较: 在保留 collected_at 的前提下,对比这批视频中可见的播放、点赞、评论、分享与浏览数据。

Douyin User Videos API 使用建议

  • 每次请求尽量只提交一种身份字段;url 与 user_id 同时存在时,backend 会选择 user_id。
  • 提交前同时校验 URL host 和 /user/{identifier} 路径;普通视频 URL 不符合此 endpoint 的输入契约。
  • 只有确实需要少于 20 条结果时才设置 results_limit,其取值必须是 1 至 20 的整数。
  • 不要把任务结果 cursor 当作抖音来源 cursor;provider 始终请求首个来源页,SocQ cursor 只读取已存储记录。
  • 作者、媒体、时长、发布时间和单项指标都可能为空;存储观察结果时可结合 id 与 collected_at。

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

探索其他平台

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

Douyin User Videos API — 常见问题

Douyin User Videos API 是一个获取单个创作者一页公开视频的接口,返回标准化视频身份、文案、作者上下文、来源 URL、时间、媒体、时长和可见互动字段。

任意一个都可满足输入要求。URL 必须属于受支持的抖音 host 且路径含 /user/{identifier};已知 user_id 可直接提交,并在两者同时存在时优先。

它控制单个 provider 来源页请求的记录数,必须是 1 至 20 的整数,未提供时默认为 20。

单条结果可包含播放、点赞、评论、分享和浏览数。各字段均为可选,来源没有提供的值会保持为空。

不能。provider 只请求首个来源页;SocQ 任务结果中的 next_cursor 仅用于翻阅该任务已经存储的记录。

每个成功的 Douyin User Videos 任务固定消耗 0.10 SocQ credits,费用不随 20 条上限内的实际返回记录数变化。