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 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。
Apple App Store API
通过已知商店链接采集公开 Apple App Store 应用详情、分类榜单和评价，并返回标准化应用与评价记录。
SEO API
查询实时 Google 自然搜索结果，比较关键词需求和排名难度，扩展种子词，找出带来网站搜索可见性的关键词与页面，并识别搜索意图。所有接口共用 SocQ API Key、异步任务流程和标准化结果格式。
Amazon API
从受支持的 Amazon 站点搜索公开商品，并采集标准化的商品详情、畅销榜、评价和卖家资料记录。
Douyin API
获取公开账号和视频，搜索视频，采集一页评论或创作者视频，并查询已知直播间。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页，并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。