snapchat/
spotlight

通过已知 snapchat.com URL 获取一条公开 Snapchat Spotlight,并在来源可用时返回标准化创作者、说明文字、媒体、音频、时间、时长和可见互动字段。

Snapchat Spotlight API

单条 Spotlight URL
创作者信息
视频快照
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Snapchat Spotlight

公开 Snapchat Spotlight 记录可以包含来源链接、说明文字、创作者身份、媒体引用、发布时间、时长、音频信息和可见互动数量。标准化结果会将这些可用字段与采集时间一并保留,便于进行指定视频审阅、内容目录补全和分时点比较。

Snapchat Spotlight API 主要特性

  • 解析已知 Spotlight提交一个公开 snapchat.com URL,将对应详情响应整理为至多一条标准记录,不扩展为内容信息流。
  • 创作者与视频上下文在固定结果结构中保留来源 URL,以及可用的说明文字、作者身份、媒体、时长、音频、标签、提及和发布时间。
  • 可见互动快照返回可用的点赞、评论、分享、播放和观看数量,并配合 collected_at 保留实际观察时间。

Snapchat Spotlight API 参数

参数必填描述
url必填必填且非空的 http 或 https URL,host 必须为 snapchat.com 或其任意子域。runtime 不限制 pathname;建议使用 /@username/spotlight/{spotlight_id} 形式的公开 Spotlight 链接。

如何使用 Snapchat Spotlight API

提交一个公开 Snapchat Spotlight URL,跟踪异步任务,并读取其已存储的标准化结果。

  1. 复制 snapchat.com 或其子域上的一个公开 Snapchat Spotlight URL。
  2. 将链接作为 url 提交到 /v1/snapchat/spotlight,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或报告失败。
  4. 读取 data.results.items;如果存储结果响应的 has_more 为 true,则继续使用其 next_cursor。
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
  -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;next_cursor 只用于已存储结果分页

Snapchat Spotlight API 最佳使用场景

  • 审阅指定 Spotlight: 将一个已知公开链接转换为可追溯记录,保留来源、说明文字、作者、媒体、时间和可用互动字段。
  • 补全内容目录: 为现有 URL 清单补充标准化视频身份、创作者信息、时长、音频、标签、提及和采集时间。
  • 比较互动快照: 将可见计数与 collected_at 配对后比较多次观察,不把这些数值理解为实时或完整统计。

Snapchat Spotlight API 使用建议

  • 只在 url 中提交一个链接;此 endpoint 不接受数组、results_limit、usernames 或 callback_url。
  • 即使校验只检查 Snapchat host 而不强制 pathname,也应使用公开 Spotlight 链接;无关的 Snapchat 路径可能在 provider 处失败。
  • 不要把任务结果中的 next_cursor 当作来源信息流分页,因为 provider 只执行一次详情查询并最多返回一条记录。
  • 允许 ID、说明文字、作者字段、媒体、时间、音频和单项互动指标为空,避免公开响应缺少字段时中断处理。
  • 将 collected_at 与互动数量一起保存,确保每项测量都对应明确的采集时间。
  • 每个成功任务按固定 0.19 积分预留预算;费用不随返回字段或结果数量变化。

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

探索其他平台

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

Snapchat Spotlight API — 常见问题

Snapchat Spotlight API 是一个用于通过已知 Snapchat URL 获取一条公开 Spotlight 并整理为标准化视频记录的 API。

可以提交 host 为 snapchat.com 或 www.snapchat.com 等子域的非空 http 或 https URL;runtime 不强制特定 pathname,但 provider 需要一个公开 Spotlight 链接。

不可以。输入只接受 url 并执行一次详情查询,因此不会发现信息流,也不接受 results_limit。

共享任务读取接口会为已存储记录返回 limit、next_cursor 和 has_more;这些字段不会把底层 Spotlight 查询变成来源端分页。

不可以。它只获取受支持的公开数据,不会登录、发布、编辑、删除、审核、管理账号或操作 Snapchat 广告。

每个成功任务固定消耗 0.19 SocQ 积分,不受返回字段是否可用或结果数量影响。