twitch/
profile

通过一个公开 Twitch username 获取标准化主页记录,包含可用身份、简介、图片、账号状态、可见指标和采集上下文。

Twitch Profile API

单 username 输入
标准化账号记录
固定请求计费
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Twitch Profile

Twitch 公开主页可能提供 username、显示名称、简介、主页图片、网站、认证或私密状态、地点信息和可见账号数量。标准化账号记录适合创作者资料补全、主页核验和可重复的公开数据快照,但不提供频道管理或需要账号授权的操作。

Twitch Profile API 主要特性

  • 精确 username 查询提交一个必填 username,可带一个可选的前导 @,主体使用 1 到 64 个受支持字符。
  • 标准化公开身份按照 AccountItem 契约读取可用主页 ID、公开 URL、username、显示名称、简介、头像、封面图和网站。
  • 账号状态信号将可用认证和私密状态保留为可空字段,provider 未提供时不会推断其值。
  • 可见主页指标将可用粉丝数、关注数和帖子数作为独立选填指标,并与采集时间关联。
  • 异步任务流程提交 username 后保存 task_id,轮询共享任务读取接口,并在成功后获取已落库的标准化结果。
  • 固定请求计费每个成功任务固定消耗 0.19 个 SocQ 积分,不随选填字段是否可用而变化。

Twitch Profile API 参数

参数必填描述
username必填必填 Twitch username。去除首尾空白后,可以一个 @ 开头,随后必须包含 1 到 64 个 ASCII 字母、数字、点、下划线或连字符。

如何使用 Twitch Profile API

提交一个受支持的 Twitch username,跟踪异步任务,再通过共享 cursor 响应读取单条已落库主页结果。

  1. 选择一个符合受支持字符规则的 Twitch 公开 username。
  2. 将 username POST 到 /v1/twitch/profile,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或报告失败。
  4. 读取 data.results.items;主页查询最多产生一条来源记录,已落库结果外层仍包含 has_more 和 next_cursor。
curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

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

Twitch Profile API 最佳使用场景

  • 创作者资料补全: 为已知创作者记录补充可用 Twitch 身份、简介、图片、网站、账号状态和公开数量。
  • username 核验流程: 将输入 handle 解析为标准化公开主页,再与内部实体或研究对象建立关联。
  • 公开账号比较: 对分别提交的 username 使用同一种 AccountItem 结构比较可见粉丝数、关注数和帖子数。
  • 主页变化监测: 将可空身份字段和指标与 collected_at 一同保存,使后续运行保持为可区分的公开快照。

Twitch Profile API 使用建议

  • 提交 username,而不是 Twitch 频道 URL;此 endpoint 不接受 url 和 results_limit 请求字段。
  • 最多使用一个前导 @;空格、斜杠、非 ASCII 字符和重复 @ 不符合 runtime username 规则。
  • 每次请求预期返回零条或一条来源主页记录;不要把任务读取接口的 limit 参数理解为主页视频或粉丝的扩展数量。
  • 将 ID、URL、简介、图片、网站、账号状态、地点和各项指标视为可空,并保留 collected_at 以比较快照。
  • 需要视频或 clips 时使用可用的独立 Twitch 内容 endpoint;此 endpoint 只读查询主页,不登录、发布、审核或管理频道。

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

探索其他平台

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

Twitch Profile API — 常见问题

Twitch Profile API 是一个通过公开 Twitch username 获取标准化账号记录的接口,包含可用身份、简介、图片、账号状态、地点、指标和采集时间。

去除首尾空白后,username 可带一个前导 @,随后使用 1 到 64 个 ASCII 字母、数字、点、下划线或连字符。空格、斜杠、更多 @ 和其他字符会被拒绝。

不可以。请求契约只接受一个必填 username,并拒绝 usernames、url、urls 和 results_limit 等调用方字段。

provider 路径最多为提交的 username 解析一个主页对象。完成结果仍使用共享落库结果外层,其中包含 limit、has_more 和 next_cursor 字段。

公开来源未提供数据时,标准化契约允许 ID、URL、username、名称、简介、图片、网站、认证、私密状态、地点和各项指标为 null。

每个成功任务固定消耗 0.19 个 SocQ 积分。固定金额不会随单条主页结果中选填字段的填充数量变化。