Snapchat 公开数据 API
将一个已知公开 Snapchat Spotlight 获取为标准化记录，并返回可用的创作者、说明文字、媒体、音频、时间、时长和互动字段。
可用的 Snapchat API
已经掌握一个公开 snapchat.com Spotlight URL，并希望获得固定结构的可用详情时，使用 Snapchat Spotlight。
可以获取哪些 Snapchat 数据？
SocQ 将一个已知公开 Spotlight 转换为固定的 ReelVideoItem 记录，只保留来源响应中可用的字段。
Spotlight 身份与来源
保留可用的内容 ID、原始公开 URL、资源类型、发布时间和采集时间。
说明文字与创作者信息
返回可用正文，以及创作者 ID、username、显示名称、主页 URL、头像、认证和私密标记。
视频、音频与分类信息
在标准化记录中保留可用媒体引用、时长、音频元数据、shortcode、标签和提及。
可见互动数据
将可用的点赞、评论、分享、播放和观看数量作为分时点公开数值采集。
SocQ 与 Snapchat 产品工具对比
SocQ 专注于受支持的公开 Spotlight 详情查询；Snapchat 应用以及创作者或商业工具面向已授权的发布、账号、受众和广告工作流。
| 能力 | SocQ | Snapchat 产品工具 |
|---|---|---|
| 主要用途 | 获取一个已知公开 Spotlight 详情 | 创建、发布、管理、分析或推广已授权内容 |
| 鉴权方式 | SocQ API key | Snapchat 账号、应用、token 或产品专用授权 |
| 起始输入 | 一个公开 snapchat.com URL | 已授权账号或产品上下文 |
| 发布或管理内容 | 不支持 | 在适用的 Snapchat 产品中提供 |
| 返回结构 | 标准化 ReelVideoItem 记录 | 产品专用 Snapchat 对象与界面 |
Snapchat API 如何工作
Snapchat Spotlight 使用异步任务，并在完成后读取已存储结果。
1. 提交公开 URL
发送一个 snapchat.com Spotlight URL，并保存返回的 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到处理成功或报告失败。
3. 读取已存储结果
读取 data.results.items；仅在共享任务读取接口报告存在更多存储记录时使用 next_cursor。
使用 SocQ API key 鉴权并提交一个公开 Spotlight URL。
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常见 Snapchat API 使用场景
指定内容研究
将一个选定 Spotlight URL 解析为可追溯记录，用于审阅和标注。
内容目录补全
为现有链接集合补充可用的创作者、说明文字、媒体、音频、时长、分类和时间字段。
互动数据快照
比较多次采集中的可见指标，同时将 collected_at 保留为实际观察时间。
限制与公开数据政策
Snapchat Spotlight 结果是分时点公开记录，不提供已授权的 Snapchat 账号操作。
- 请求体只接受一个必填 url，并拒绝 results_limit 或 callback_url 等额外字段。
- 校验接受 snapchat.com 及其子域，但不强制 pathname；应使用公开 Spotlight 链接，因为无关路径可能在 provider 处失败。
- provider 只执行一次详情查询并最多返回一条标准化记录，不会获取 Spotlight 信息流。
- 已存储结果分页属于共享任务读取接口，不是 Snapchat 来源分页。
- 说明文字、创作者、媒体、发布时间、音频、时长、分类和单项指标等选填字段可能为空。
- 此 endpoint 不会登录、发布、编辑、删除、审核、管理账号或操作广告。
Snapchat API 常见问题
Snapchat Spotlight API 会获取什么？
它会获取一个已知公开 Spotlight，并根据采集时来源可用字段最多返回一条标准化记录。
Snapchat API 会采集 Spotlight 信息流吗？
不会。当前 endpoint 是单条详情查询，不接受主页、搜索词、来源 cursor 或 results_limit 来发现内容。
返回的互动数量是实时的吗？
不是。应将可用数量视为 collected_at 时刻采集的公开快照，而不是完整或持续更新的分析数据。
SocQ 可以向 Snapchat 发布内容吗？
不可以。这个公开数据 endpoint 不提供登录、发布、账号管理、审核或广告操作。
Snapchat Spotlight 如何计费？
每个成功任务固定消耗 0.19 SocQ 积分，不受字段是否可用或结果数量影响。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Twitch API
将一个已知公开 Twitch username 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。