Snapchat Spotlight Comments
Snapchat Spotlight 评论是与一个指定 Spotlight 内容关联的公开回应。SocQ 将每条返回记录保存为 CommentItem，其中包含来源身份、评论正文、可用作者信息、父评论与内容引用、发布时间与采集时间，以及可见点赞数或回复数。
主要特性
- 每个任务提交一个 Spotlight URL提交一个位于 snapchat.com 或其子域的非空 url；provider 针对该目标请求一页来源数据。
- 标准化评论记录通过稳定的 CommentItem 1.0 结果结构读取评论 ID、正文、来源 URL、时间和可用作者身份。
- 线程与互动上下文来源提供时保留 parent_id、post_id、likes_count 和 replies_count；不把缺失字段当作零，也不据此承诺完整线程。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填的非空 Snapchat URL。运行时校验接受 snapchat.com 及其子域；请使用规范公开 /@username/spotlight/{spotlight_id} URL，确保 provider 收到目标 Spotlight 资源。 |
如何使用
提交一个公开 Snapchat Spotlight URL，跟踪异步任务，再通过任务结果分页读取已存储的标准化评论。
- 复制要查看的规范公开 Snapchat Spotlight URL。
- 将 url POST 到 /v1/snapchat/spotlight-comments，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；若已存储结果跨多个 API 响应页，则在 has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 定性回应审阅： 结合返回的公开评论正文和可用作者信息，查看指定 Spotlight 下的问题、反应与重复主题。
- 保留来源关联的评论档案： 保存评论 ID、来源 URL、post_id、parent_id、published_at 和 collected_at，让每条回应保留可获得的来源依据。
- 可见互动快照： 比较返回评论中可获得的 likes_count 与 replies_count，并用 collected_at 标定每次观察。
使用建议
- 运行时校验只检查 Snapchat 主机而不强制具体路径，但仍应使用规范公开 /@username/spotlight/{spotlight_id} URL。
- 提交 payload 中不要发送 cursor 或 results_limit；该 endpoint 只拥有 url 字段，并采集一页 provider 来源数据。
- 将 parent_id 和 replies_count 视为可获得的上下文，不要把它们当作结果包含完整回复树的证明。
- 来源未提供时，允许 ID、URL、正文、作者字段、published_at、parent_id、post_id 和指标为 null。
- 区分 provider 采集深度与 GET /v1/tasks/{task_id} 分页；后者的 cursor 只分页读取已完成任务保存的结果。
相关 API
需要其他类型的 Snapchat 公开数据时，可以使用以下 API。
- Snapchat Profile API
- Snapchat Spotlight API — 获取一个已知公开 Snapchat Spotlight，并在来源可用时返回标准化创作者、说明文字、媒体、音频、时间、时长和可见互动字段。