Twitch 公开数据 API
将一个已知公开 Twitch username 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。
可用的 Twitch API
使用 Twitch Profile API 获取标准化账号身份，或使用 Twitch User Videos API 按受支持的类型和排序参数获取一页公开视频。
可以获取哪些 Twitch 数据？
Twitch 目录可通过一个 username 返回一条标准化公开账号记录或一页标准化公开视频；来源没有提供值时保留可空字段。
主页身份
获取可用账号 ID、公开 URL、username、显示名称和简介。
主页展示
保留可用头像、封面图和关联网站字段。
账号信号
读取可空认证和私密状态，不推断缺失值。
可见账号数量
将可用粉丝数、关注数和帖子数与 collected_at 一同保存，用于时间点比较。
用户公开视频
从一页来源结果获取视频标识、创作者信息、媒体、时长、发布时间和可见互动指标。
SocQ 与 Twitch API 对比
SocQ 在标准化任务流程中提供公开主页和用户视频查询；需要原生资源或授权频道操作时，应使用 Twitch 原生 API 和相应授权。
| 能力 | SocQ | Twitch API |
|---|---|---|
| 主要用途 | 解析公开主页或采集一页用户视频 | 围绕 Twitch 资源构建原生集成 |
| 鉴权 | SocQ API key | Twitch 应用与适用的用户或应用授权 |
| 起始输入 | 一个 username | 原生请求参数和 Twitch 资源标识 |
| 频道管理 | 不支持 | 使用 Twitch 授权 API 和所需权限 |
| 响应格式 | 标准化 SocQ AccountItem 或 ReelVideoItem 记录 | Twitch 原生响应对象 |
Twitch API 如何工作
两个 Twitch API 都使用 SocQ 共享异步任务和落库结果流程。
1. 选择 endpoint
将一个有效公开 username POST 到 /v1/twitch/profile 或 /v1/twitch/user-videos，并保存 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到任务成功或失败。
3. 读取落库记录
从 data.results.items 读取主页或视频记录，并保留采集时间上下文。
使用 SocQ API key 鉴权并准确提交一个受支持 username。成功任务固定消耗 0.19 个积分。
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 API 使用场景
创作者身份补全
为已知创作者记录补充可用 Twitch 身份、简介、图片、网站、账号状态和公开数量。
handle 解析
先解析输入 username，再将公开主页与内部研究实体建立关联。
账号比较
通过相同的可空身份和指标字段比较分别采集的主页。
快照监测
将 collected_at 与公开主页值一同保留，使后续运行成为可区分的快照。
视频目录补全
为已知频道补充公开视频标识、媒体、创作者信息、时长、时间和可见互动指标。
限制与公开数据政策
Twitch endpoints 是只读公开主页和用户视频查询，不提供需要授权的频道操作或受众成员数据。
- 请求只接受一个 username，不接受频道 URL、username 列表或 results_limit。
- username 可带一个前导 @，其余部分必须使用 1 到 64 个 ASCII 字母、数字、点、下划线或连字符。
- 主页查询最多返回一个来源主页对象；User Videos 只采集一页来源结果，不接受调用方控制的 cursor 或 results_limit。
- 公开来源没有提供数据时，主页身份、图片、网站、状态、地点和各项指标可能为 null。
- 此 endpoint 不登录、发布、审核或管理频道，不获取私密分析，也不执行需要 OAuth 授权的账号操作。
Twitch API 常见问题
Twitch API 是什么？
Twitch APIs 通过异步任务将一个已知公开 username 解析为标准化主页，或采集一页该用户的公开视频。
目前提供哪些 Twitch API？
目前提供 Twitch Profile API 和 Twitch User Videos API。
可以提交 Twitch URL 吗？
不可以。当前请求契约要求 username，并拒绝 url、urls 和其他未声明字段。
此 API 会管理 Twitch 频道吗？
不会。两个 endpoints 都只读查询公开数据，不认证 Twitch 用户，不发布、审核或管理频道设置，也不获取私密分析。
为什么字段可能为 null？
来源或 provider 在采集时未公开某个值时，标准化账号和视频记录会将对应选填公开字段保留为 null。
Twitch 请求如何计费？
每个成功的 Twitch Profile 或 User Videos 任务固定消耗 0.19 个 SocQ 积分。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Amazon API
从受支持的 Amazon 站点搜索公开商品，并采集标准化的商品详情、畅销榜、评价和卖家资料记录。