snapchat/
spotlight-comments

通过 Snapchat Spotlight URL 采集一页来源评论,返回标准化正文、作者、线程引用、时间和可见互动字段。

Snapchat Spotlight Comments API

Spotlight URL 输入
单页来源采集
标准化评论
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Snapchat Spotlight Comments

Snapchat Spotlight 评论是与一个指定 Spotlight 内容关联的公开回应。SocQ 将每条返回记录保存为 CommentItem,其中包含来源身份、评论正文、可用作者信息、父评论与内容引用、发布时间与采集时间,以及可见点赞数或回复数。

Snapchat Spotlight Comments API 主要特性

  • 每个任务提交一个 Spotlight URL提交一个位于 snapchat.com 或其子域的非空 url;provider 针对该目标请求一页来源数据。
  • 标准化评论记录通过稳定的 CommentItem 1.0 结果结构读取评论 ID、正文、来源 URL、时间和可用作者身份。
  • 线程与互动上下文来源提供时保留 parent_id、post_id、likes_count 和 replies_count;不把缺失字段当作零,也不据此承诺完整线程。

Snapchat Spotlight Comments API 参数

参数必填描述
url必填必填的非空 Snapchat URL。运行时校验接受 snapchat.com 及其子域;请使用规范公开 /@username/spotlight/{spotlight_id} URL,确保 provider 收到目标 Spotlight 资源。

如何使用 Snapchat Spotlight Comments API

提交一个公开 Snapchat Spotlight URL,跟踪异步任务,再通过任务结果分页读取已存储的标准化评论。

  1. 复制要查看的规范公开 Snapchat Spotlight URL。
  2. 将 url POST 到 /v1/snapchat/spotlight-comments,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或返回失败。
  4. 读取 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

Snapchat Spotlight Comments API 最佳使用场景

  • 定性回应审阅: 结合返回的公开评论正文和可用作者信息,查看指定 Spotlight 下的问题、反应与重复主题。
  • 保留来源关联的评论档案: 保存评论 ID、来源 URL、post_id、parent_id、published_at 和 collected_at,让每条回应保留可获得的来源依据。
  • 可见互动快照: 比较返回评论中可获得的 likes_count 与 replies_count,并用 collected_at 标定每次观察。

Snapchat Spotlight Comments API 使用建议

  • 运行时校验只检查 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 只分页读取已完成任务保存的结果。

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

  • Snapchat Profile API
  • Snapchat Spotlight API — 获取一个已知公开 Snapchat Spotlight,并在来源可用时返回标准化创作者、说明文字、媒体、音频、时间、时长和可见互动字段。

探索其他平台

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

Snapchat Spotlight Comments API — 常见问题

Snapchat Spotlight Comments API 是一个用于采集指定 Snapchat Spotlight URL 所关联的一页公开评论记录的 API。

提交契约只接受一个必填 url 字符串。运行时要求主机为 snapchat.com 或其子域;应使用规范公开 /@username/spotlight/{spotlight_id} 形式指向目标资源。

不可以。提交契约没有 results_limit 或 cursor 字段,provider 集成只发起一次来源请求。

该 cursor 属于 GET /v1/tasks/{task_id}。它只分页读取成功任务已存储的评论,响应默认 limit 为 50,可设置为 1 到 500;不会再抓取一页 Snapchat 来源数据。

CommentItem 1.0 包含 id、platform、resource、type、url、published_at、collected_at、text、author、parent_id、post_id,以及含 likes_count 和 replies_count 的 metrics。来源未提供时,可空字段保持为 null。

每个成功的 Snapchat Spotlight Comments 任务固定消耗 0.19 SocQ 积分,与该来源页返回的评论数量无关。