Snapchat 有没有公开的主页、快拍和 Spotlight API?
把 Snapchat 当网页来采,和把 TikTok 当网页来采,失败方式不一样。TikTok 改 class,你往往还能补选择器。Snapchat 公开页对机房出口更不友好:打开 snapchat.com/@用户名,从英雄区抠订阅数、给快拍托盘截图、把 Spotlight 分享链接丢进无头浏览器——class 一换、快拍媒体链在下载中途过期、机房 IP 撞上登录墙,整列监测一起哑。公开主页、24 小时快拍、Spotlight 片子并没有下线,失效的是 HTML 合同。之前那套「能跑再说」的采集,在 Snapchat 上不是修选择器就能续命。
官方也没有按用户名读主页、快拍、Spotlight 或镜头目录的接口。登录套件和广告接口是往自己账号里写,或管投放,带不走别人的公开卡片。正确做法不是再写一套选择器,而是走 Snapchat 内容 API 的 GET:用户名进去,JSON 出来,用三个布尔标记决定后面还要不要花钱。打开本页或复制示例不会发请求。
登录后从控制台复制授权密钥,放在服务端环境变量 OPENDATA_API_KEY。curl 里的 YOUR_API_KEY 只是占位。密钥走查询串,不要出现在工单、截图和浏览器前端。
只监 TikTok 的栈还缺一块
达人表里多半已有 TikTok、Instagram、YouTube。Snapchat 那一列常年空着,因为团队仍把它当成私密聊天。公开面其实不小:带订阅数的主页、24 小时公开快拍、置顶精选、带播放量和评论的 Spotlight,以及 AR 镜头目录。只监 TikTok 的栈,会把「这周 Snap 没数据」写成「达人停更」——那天对方可能发了三条快拍加一条 Spotlight。这是覆盖缺口,不是安静的一周。
错的补法是把 TikTok 那套 HTML 采集再套到 Snapchat 网页上。对的补法是同一类任务——关注列表、每日主页、快拍归档、Spotlight 评论进审核——改打 REST,不打 CSS。路径统一为 https://api.opendata-api.com/api/project/snapchat-content/<operation>。HTTP 4xx/5xx 是传输、鉴权或额度,该查密钥和余额。HTTP 200 不等于找到了人:业务体还有 success 和 data,用户名不存在时经常仍是 HTTP 200 且 success: false。当成未命中,不要当账号抖动去连打。网关若再包一层 {code, message, data},先看 code 是不是 200,再剥到带 success 的那一层。把「传输成功」和「handle 解析成功」写成同一个绿灯,日报会把空号当成停更。
用户名是 handle,不是手机号
这个项目上最常见的错法,是把表格里的手机号直接塞进 username。主页相关接口只收不带 @ 的 username。不收手机号、邮箱,也不收从别的产品里抄来的内部 id。把号码塞进 get-profile 不会变成注册探测。查号是另一个项目,见 Snapchat 号码查询。
轻量卡片的文档示例是 brentrivera。下面这行在你换成真实密钥并执行之前,什么都不会查。
curl "https://api.opendata-api.com/api/project/snapchat-content/get-profile?username=brentrivera&key=YOUR_API_KEY"
命中时 data.info 里有 username、title(显示名)、bio、websiteUrl、subscriberCount(字符串,排序前先转整数)、头像和 Snapcode,以及 hasStory、hasCuratedHighlights、hasSpotlightHighlights。这三个标记才是「之后」。之前那种写法是每个账号都去打 get-user-story 和 get-user-curated-highlights「以免漏」。空轮询照样扣点。success: false 是 handle 解析失败;hasStory: false 是人在、此刻没有快拍。两件事不要合成一个「没数据」。订阅数当日入库即可,不必为了多一个字段再打整份足迹。
已经确定要整份公开足迹时,才用 get-full-profile 一次拿 profile、story、curatedHighlights、spotlightHighlights、lenses。几百个账号的日更名单,默认不该全走这一枪——多数行只要订阅数和三个标记。手里只有关键词、没有 handle 时,再用搜索,文档示例是 keyword=music,结果按 Spotlight、镜头、创作者、地点分组。搜索命中只是候选,归档前仍要用 get-profile 确认用户名。
快拍、Spotlight,再到 Lenses
错的归档是只留一列叫「Snapchat 内容」。快拍 24 小时过期。精选不过期。Spotlight 是带播放量和评论的短视频对象。镜头是 AR 效果,不是帖子。把这四样揉成一个字段,时间含义就没了:昨天的快拍、上周置顶的精选、一条分享链接上的片子,会变成同一格里的「有内容」。
主页卡片之后的顺序:
hasStory为真再调get-user-story。有快拍则data是带媒体地址的对象;没有则success: true且data: null——这是答案,不是故障。要归档就一天扫几次;标记为假就跳过。hasCuratedHighlights为真再调精选接口,拿置顶、不随 24 小时消失的合集。- 手里是 Spotlight 分享链接 时,才走
get-spotlight-by-link;评论走get-spotlight-comments-by-link。用户名不是这两个接口的入参。链接要完整 URL 编码,不要自行截断。 - 镜头是目录。
get-trending-lenses返回大约 24 条topLenses(lensId、name、creatorName、creatorIsOffical、图标和 deeplink)。按标签查是另一条路,例如halloween。
import os
import requests
BASE = "https://api.opendata-api.com/api/project/snapchat-content"
KEY = os.environ["OPENDATA_API_KEY"].strip()
def call(operation, **params):
resp = requests.get(
f"{BASE}/{operation}",
params={"key": KEY, **params},
timeout=60,
)
if not resp.ok:
raise RuntimeError(f"HTTP {resp.status_code}")
body = resp.json()
# Unwrap gateway {code, data}; HTTP 200 is not business success
while isinstance(body, dict) and "code" in body and isinstance(
body.get("data"), (dict, list)
):
if str(body.get("code")) != "200":
raise RuntimeError(body.get("message"))
body = body["data"]
return body
# After: card first, then flags. Before would call get-user-story on every row.
payload = call("get-profile", username="snoopdogg")
if not payload.get("success"):
raise SystemExit("handle did not resolve")
info = (payload.get("data") or {}).get("info") or {}
if info.get("hasStory"):
story = call("get-user-story", username="snoopdogg")
live = story.get("data") is not None
link = (
"https://www.snapchat.com/spotlight/"
"W7_EDlXWTBiXAEEniNoMPwAAYa3F2d2VwcG5uAY336_EbAY3368kUAAAAAQ"
)
spot = call("get-spotlight-by-link", spotlight_link=link)
comments = call("get-spotlight-comments-by-link", spotlight_link=link)
snoopdogg 只是文档里的快拍示例,不保证此刻有快拍。success 为真且 data 为 null,表示今天没有可归档的,不是「再打几次就会有」。Spotlight 分享链接是另一类对象:metadata.videoMetadata.contentUrl 才是文件地址(若有),engagementStats 里的 viewCount、shareCount、commentCount 按字符串返回,评论必须另一次调用。llmTitle / llmKeywords 只适合打标,不能当成播放量已经验证。执行这段才会扣点,复制不会。
这不是 Snapchat 查号
这个项目不问某个手机号在不在 Snapchat。它不收 number,不返回 registered,也不会开会话。表格里是号码,就停,去用 Snapchat 号码查询。把手机号塞进 username 不是一种降级策略。
不要把爬 snapchat.com 当正式对接。不要把 HTTP 200 当成命中——看 success,快拍接口的 data: null 是空的一天。不要每个账号都打快拍、精选和 Spotlight「以免漏」,三个布尔值就是用来跳过空轮询的。不要把用户名传给 get-spotlight-by-link,也不要把 Spotlight 链接传给 get-profile。不要指望私信、非公开快拍、好友关系、实时位置或发信接口。不要把 key 写进前端。不要把 subscriberCount 当成 KYC。
查号项目上的 public-profile 只是 handle 是否存在的卡片(显示名、snapcode),不是快拍、Spotlight 或镜头——另一个项目,另一套信封。把两套接口揉进同一张「Snapchat 结果表」,注册标记和订阅数会对不上号:一边在问号码在不在,一边在问这个 handle 今天有没有可归档的公开内容。产品页:Snapchat 内容 API。