Snapchat 有没有公开的主页、快拍和 Spotlight API？

发布于 2026年10月1日

做出海社媒的同学大概都遇到过这种情况：TikTok、Instagram、YouTube 的达人数据早就接进系统了，一到 Snapchat 就卡住。Snap 官方开放的是 Login Kit、Creative Kit 和广告 API，没有任何官方接口能按用户名查公开主页、拉快拍或者读取 Spotlight 视频数据，市面上大多数社交监听工具也直接跳过了 Snapchat。

可 Snapchat 在美国、欧洲和中东 Gen Z 里的渗透率非常高。投美区、沙特、阿联酋年轻用户的品牌方，做 KOL 筛选、竞品监测时，Snapchat 这块空白是绕不过去的。

Snapchat 内容 API（snapchat-content） 就是用来补这块空白的：一个简单的 REST JSON 接口，不需要 Snapchat 账号登录、不用接 SDK，也不用申请合作伙伴白名单，就能读取公开主页、快拍、精选、Spotlight 视频与评论、站内搜索以及 AR 镜头目录。

接口一览

所有接口都是 GET 请求，统一格式：

https://api.opendata-api.com/api/project/snapchat-content/<operationId>?key=YOUR_API_KEY&参数=值

按用途分为四组：

分组operationId说明
主页get-profile按用户名查公开主页：昵称、简介、订阅数、头像、Snapcode
主页get-full-profile一次返回主页 + 当前快拍 + 精选 + Spotlight 精选 + 已发布镜头
主页get-user-story用户当前 24 小时内的公开快拍
主页get-user-curated-highlights / get-user-spotlight-highlights主页上置顶的精选合集 / Spotlight 作品
Spotlight 与快拍get-spotlight-by-link通过分享链接解析 Spotlight 视频地址、时长、播放量等
Spotlight 与快拍get-spotlight-comments-by-link通过分享链接拉取 Spotlight 公开评论
Spotlight 与快拍get-story-by-link / get-spotlight-feed按链接解析快拍；获取公开 Spotlight 推荐流
搜索get-search / get-search-lenses关键词搜索 Spotlight、创作者、话题、地点；搜索镜头
镜头get-trending-lenses、get-lens-item、get-lenses-by-hashtag 等热门镜头、镜头详情、按标签查镜头、脸部/世界/音乐镜头目录、镜头创作者目录

请求示例

1. 按用户名查 Snapchat 公开主页

curl "https://api.opendata-api.com/api/project/snapchat-content/get-profile?key=YOUR_API_KEY&username=brentrivera"

用户名不带 @。返回结构为 {success, data:{info, metadata}}，info 中常用字段：

  • username、title（显示昵称）、bio（简介）
  • subscriberCount：订阅数（字符串类型，入库前记得转数字）
  • profilePictureUrl、snapcodeImageUrl：头像与 Snapcode 图片
  • websiteUrl、badge、categoryStringId：外链、认证徽章与分类
  • hasStory、hasCuratedHighlights、hasSpotlightHighlights：是否有快拍/精选/Spotlight，用来决定后续要不要继续调用

用户名不存在时依然返回 HTTP 200，但 success=false、data="data not found"，判断时以 success 为准。

2. Python：拉取达人的完整公开足迹

做 KOL 档案时推荐直接用 get-full-profile，一次请求拿全：

import requests

BASE = "https://api.opendata-api.com/api/project/snapchat-content"
KEY = "YOUR_API_KEY"

def full_profile(username: str) -> dict:
    # One call returns profile, story, highlights, spotlight highlights and lenses
    r = requests.get(f"{BASE}/get-full-profile",
                     params={"key": KEY, "username": username}, timeout=30)
    r.raise_for_status()
    body = r.json()
    if not body.get("success"):
        raise ValueError(f"profile not found: {username}")
    return body["data"]

data = full_profile("therock")
info = data["profile"]["info"]
print(info["title"], int(info.get("subscriberCount") or 0))
print("story live:", data["story"] is not None)
print("highlights:", len(data["curatedHighlights"]))
print("lenses:", len(data["lenses"]))

story 没有快拍时为 null，三个数组没有内容时为空数组。

3. 通过链接下载 Snapchat Spotlight 视频

curl -G "https://api.opendata-api.com/api/project/snapchat-content/get-spotlight-by-link" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "spotlight_link=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYa3F2d2VwcG5uAY336_EbAY3368kUAAAAAQ"

链接需要完整传入并做 URL 编码。返回中：

  • metadata.videoMetadata.contentUrl：视频文件地址，可直接下载；另有 thumbnailUrl、durationMs、uploadDateMs、creator
  • metadata.engagementStats：viewCount、shareCount、commentCount 等互动数据（字符串）
  • llmTitle、llmDescription、llmKeywords：AI 生成的标题、描述与关键词，适合做内容打标
  • hashtags、contextCards（创作者与原声信息）

同一链接传给 get-spotlight-comments-by-link，就能拿到评论文本和评论者信息，方便接情感分析或审核流程。

4. 热门镜头（Lens）排行

curl "https://api.opendata-api.com/api/project/snapchat-content/get-trending-lenses?key=YOUR_API_KEY"

返回 data.topLenses，约 24 个镜头，含 lensId、name、creatorName、creatorIsOffical（是否官方镜头）、iconUrl、deeplinkUrl。拿 lensId 调 get-lens-item 可获得预览视频 lensPreviewVideoUrl、解锁链接 unlockUrl 以及相关镜头列表。

典型使用场景

  • 出海 KOL 筛选与监测：按用户名批量拉订阅数、简介、外链，和 TikTok、Instagram 数据放进同一张达人表。
  • 品牌舆情与安全：定期抓取目标账号的快拍和 Spotlight 评论，补齐统一监测体系里缺失的 Snapchat。
  • AR 镜头趋势研究：跟踪热门镜头、按 hashtag 查镜头、翻阅镜头创作者目录，为品牌定制滤镜找合作方。
  • 达人媒体资料包（Media Kit）：自动生成包含订阅数、精选合集、Spotlight 作品的达人报告。
  • 内容归档与下载工具：把用户粘贴的 Spotlight 或快拍链接解析成可下载的媒体地址。
  • AI Agent / n8n 工作流：标准 REST + API Key，无需 OAuth，直接作为 Snapchat 数据源接入。

对接建议

  • 先查主页再按需深挖：get-profile 返回的三个布尔标记能告诉你账号有没有快拍、精选和 Spotlight，没有就跳过对应接口，节省调用次数。
  • 数字字段统一转换：订阅数、播放量、分享数等都以字符串返回，入库前统一转成整数，便于排序和做增长曲线。
  • 快拍要定时轮询：快拍只保留 24 小时，如果要做内容归档，建议每隔几个小时抓取一次并及时转存媒体文件。
  • 链接参数做 URL 编码：Spotlight 和快拍分享链接里含有特殊字符，务必完整编码后再传入。
  • 大结果做好分页与缓存：搜索接口对宽泛关键词的返回可能较大，镜头目录类接口请用 cursor 分页，并在本地缓存已抓取的数据。

常见问题

Snapchat 有没有公开的主页、快拍和 Spotlight API？ 官方没有。Snap 的开发者平台只提供登录、分享和广告相关能力。本接口读取的是 Snapchat 网页端本就公开可见的主页、快拍和 Spotlight 内容，并整理成结构化 JSON。

怎么不登录获取 Snapchat 用户资料和公开故事？ 调用 get-profile 拿主页资料，再用 get-user-story 拿当前公开快拍，全程不需要 Snapchat 账号。注意快拍 24 小时过期，可以先看 hasStory 再决定是否请求，避免空轮询。

如何通过链接下载 Snapchat Spotlight 视频？ 把分享链接传给 get-spotlight-by-link，从 metadata.videoMetadata.contentUrl 取视频文件地址即可。

Snapchat 热门镜头/滤镜数据怎么采集？ get-trending-lenses 看实时热门；get-face-lenses、get-world-lenses、get-music-lenses 分页浏览脸部、世界、音乐镜头目录（把上一页返回的 cursor 传回去翻页）；get-lenses-by-hashtag 和 get-search-lenses 按标签或关键词查。

Snapchat KOL 监测怎么对接 API？ 维护一份达人用户名列表，定时调用 get-full-profile，把 subscriberCount 等字段落库做时间序列，就能看到粉丝增长和内容更新频率。

快拍、精选和 Spotlight 接口有什么区别？ 快拍（Story）是 24 小时后消失的动态，对应 get-user-story；精选（Highlights）是创作者置顶的长期合集，对应 get-user-curated-highlights；Spotlight 是类似短视频推荐流的公开作品，带播放量和评论，对应 get-user-spotlight-highlights 和 get-spotlight-by-link。

怎么用用户名查 Snapchat 公开主页？ get-profile?username=xxx 即可，用户名不带 @。如果只知道关键词不知道账号，可以先用 get-search 搜索，结果中的创作者分组会列出相关公开账号。

为什么大部分社交监听 API 都不覆盖 Snapchat？ Snapchat 以私密聊天为主，公开内容入口分散在主页、快拍、Spotlight 和镜头几个地方，且没有官方数据接口，自建采集维护成本高。本接口把这些入口统一成一套 REST API，省掉了这部分工作。

更多支持

如果你还需要 TikTok、Instagram、YouTube Shorts、小红书、Lemon8 等相似平台的数据接口，可以通过联系我们页面提出需求，我们会按需新增。对数据安全或调用量有更高要求的团队，也支持源码级私有化部署。

立即试用

在 Snapchat 内容 API 页面在线测试，或查看 get-profile、get-full-profile、get-spotlight-by-link 与 get-trending-lenses 的参考文档。单次调用费用见定价，注册即送免费测试额度。