Douyin User Profile API

Douyin User Profile

主要特性

• 两种受支持的标识可以通过受支持的 Douyin 用户主页 URL，或符合运行时标识规则的 user_id 解析一个公开主页。
• 主页身份与展示信息在一条账号记录中返回可用主页 ID、公开 URL、用户名、显示名称、简介、头像、封面图和关联网站。
• 明确的账号状态字段将可用认证和私密状态保留为可空值，公开来源未提供时不会推断账号状态。
• 可见主页数量将可用粉丝数、关注数和帖子数标准化，并与 collected_at 一同表示公开主页在特定采集时间的状态。

参数

如何使用

提交一种受支持的主页标识，跟踪异步任务，再从落库结果外层读取标准化账号。

1. 准备带有 /user/<identifier> 路径的完整 Douyin 主页 URL，或受支持的公开 user_id。
2. 将一个标识 POST 到 /v1/douyin/user-profile，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 成功后读取 data.results.items；来源查询最多产生一条主页记录，落库结果外层仍会报告 has_more 和 next_cursor。

curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化账号

最佳使用场景

• 创作者资料补全： 为已有创作者记录补充可用 Douyin 身份、简介、图片、网站、账号状态和公开数量。
• 主页身份核验： 先将已知主页 URL 或用户标识解析为一致账号对象，再与内部实体建立关联。
• 公开账号比较： 对分别采集的主页使用相同标准化指标键，比较粉丝数、关注数和帖子数。
• 主页快照监测： 将身份字段和公开指标与 collected_at 一同保存，使后续任务保持为可区分的时间点观察。

使用建议

• 已有规范用户标识时只提交 user_id；如果 url 与 user_id 指向不同对象，provider 请求会优先使用 user_id。
• 提交 URL 前先检查主机名，并要求路径包含 /user/<identifier>，从而在本地拒绝视频链接或其他 Douyin 资源地址。
• 每个来源查询预期返回零条或一条主页记录；任务读取 cursor 只分页读取 SocQ 已落库项目，不能向 provider 请求下一页主页。
• 将身份、图片、网站、账号状态、地点和各项指标视为可空，并在比较重复快照时保留 collected_at。

相关 API