Snapchat 内容 API - 用户主页、快拍、Spotlight 与镜头 APIs

按用户名查询 Snapchat 公开主页，获取账号的公开身份卡片。用户名不带 @（如 brentrivera）。返回结构为 {success, data:{info, metadata}}：info 包含 username、title（昵称）、bio、subscriberCount（字符串形式的订阅数）、profilePictureUrl、snapcodeImageUrl、squareHeroImageUrl、hostUserId、businessProfileId、badge、websiteUrl、categoryStringId / subcategoryStringId、relatedAccountsInfo，以及 hasStory、hasCuratedHighlights、hasSpotlightHighlights 三个布尔标记，可据此判断哪些后续接口值得调用；metadata 包含 pageTitle、pageDescription、pageType 与 shareId。用户名不存在时返回 HTTP 200，且 success=false、data="data not found"。

一次请求获取 Snapchat 账号的全部公开信息。传入用户名（如 therock）。返回结构为 {success, data:{profile, story, curatedHighlights, spotlightHighlights, lenses}}：profile 与「按用户名查询公开主页」的 info/metadata 一致（username、title、bio、subscriberCount、profilePictureUrl、snapcodeImageUrl、creationTimestampMs、lastUpdateTimestampMs、relatedAccountsInfo 及各类标记），story 为当前公开快拍对象或 null，另外三个数组分别列出该账号的置顶精选合集、Spotlight 精选和已发布镜头（没有时为空数组）。用户名不存在时返回 HTTP 200，且 success=false、data="data not found"。

返回 Snapchat 账号当前在播的 24 小时公开快拍。传入用户名（如 snoopdogg）。有快拍时 data 为快拍对象，包含各条 snap 及其媒体地址；账号当前没有快拍时调用仍成功，返回 {success:true, data:null}。快拍 24 小时后过期，结果全天都在变化——如需避免空轮询，可先用「按用户名查询公开主页」查看 hasStory。用户名不存在时返回 HTTP 200，且 success=false、data="data not found"。

列出 Snapchat 创作者置顶在公开主页上的精选合集——不会在 24 小时后过期的常驻快拍集合。传入用户名（如 benazelart）。返回 {success, data}，包含该创作者的精选合集及其中的 snap；没有精选的账号返回空结果。可先通过「按用户名查询公开主页」的 hasCuratedHighlights 判断账号是否有精选。用户名不存在时返回 HTTP 200，且 success=false、data="data not found"。

列出 Snapchat 创作者在公开主页展示的 Spotlight 视频。传入用户名（如 benazelart）。返回 {success, data}，包含该创作者的 Spotlight 精选条目，可再通过「按分享链接获取 Spotlight 视频」进一步解析。没有 Spotlight 精选的账号返回空结果；主页上的 hasSpotlightHighlights 可提前判断。用户名不存在时返回 HTTP 200，且 success=false、data="data not found"。

列出 Snapchat 创作者发布的公开 AR 镜头。传入创作者用户名（如 jsprinz）。返回 {success, data}，包含归属该账号的镜头，每个镜头都可通过 lensId 调用「按镜头 ID 获取详情」展开。未发布镜头的账号返回空结果。用户名不存在时返回 HTTP 200，且 success=false、data="data not found"。

将 Snapchat Spotlight 分享链接解析为完整的视频元数据、互动数据和媒体。传入完整的 spotlight_link（https://www.snapchat.com/spotlight/...）。返回的 data 包含 metadata.engagementStats（viewCount、shareCount、commentCount、boostCount、recommendCount，均为字符串）、metadata.videoMetadata（contentUrl 视频文件、thumbnailUrl、durationMs、uploadDateMs、creator、name、description）、AI 生成的 llmTitle / llmDescription / llmKeywords、hashtags、contextCards（创作者与原声）、deeplink，以及 story 区块（snapList 各条 snap 媒体地址、storyId、storyType、thumbnailUrl）和 upNextThumbnailUrl。

抓取 Snapchat Spotlight 视频下方的公开评论。传入完整的 spotlight_link（https://www.snapchat.com/spotlight/...）。返回 {success, data}，包含公开 Spotlight 页面可见的评论——评论内容与评论者信息，可直接接入情感分析或内容审核流程。如需评论总数 commentCount，可对同一链接调用「按分享链接获取 Spotlight 视频」。

获取当前公开、非个性化的 Snapchat Spotlight 发现推荐流，无需任何参数。返回 {success, data}，包含公开推荐流当前展示的 Spotlight 视频，单条内容可通过「按分享链接获取 Spotlight 视频」展开。推荐流会随时间轮换，重复调用是采样当下热门内容的好方法。

将 Snapchat 公开快拍分享链接解析为其中的 snap 与媒体。传入完整的 story_link，格式为 https://story.snapchat.com/p/{profileId}/{storyId}。返回 {success, data}，包含快拍对象及各条 snap 的媒体地址。适用于手里有某条具体分享快拍、而非用户名的场景；若要获取用户当前在播的内容，请使用「获取用户当前公开快拍」。

对关键词执行 Snapchat 公开搜索，结果按内容类型分组返回。传入 keyword（如 music）。返回结构为 {success, data:{sections:[{title, results[]}]}}，分组包括 Spotlight（快拍卡片）、Lenses、Topics、Subscribe（公开创作者主页）、Places、Shows 与 Episodes——每条结果都带类型化负载（result.$case）和 ID。宽泛关键词的响应可能较大（约 100 KB）。

按关键词搜索 Snapchat 公开 AR 镜头库。传入 keyword（如 funny）。返回 {success, data}，包含匹配的镜头，每个镜头含 lensId 等标识以及名称、创作者和预览/图标图片，可通过「按镜头 ID 获取详情」查看完整信息。

获取 Snapchat 当前热门的 AR 镜头，无需任何参数。返回结构为 {success, data:{topLenses:[...]}}，约 24 条；每个镜头对象包含 lensId、name、creatorName、creatorUserId、creatorProfileId、creatorIsOffical（是否为 Snapchat 官方镜头）、iconUrl、thumbnailUrl、thumbnailSequence，以及可直接打开镜头的 deeplinkUrl。

将 Snapchat 镜头 ID 解析为完整展示信息。传入 lens_id（32 位十六进制 ID，如 41a72e9ae9a44f8891327ce6cf1c344d）。返回的 data 包含 lensDisplayInfo（lensId、lensName、iconUrl、lensPreviewImageUrl、lensPreviewVideoUrl、lensCreatorDisplayName、lensCreatorUsername、lensCreatorSearchTags、isOfficialSnapLens、scannableUuid、scannableImageUrl、unlockUrl、userProfileUrl、lastUpdatedEpoch）、lensMetadata（可能为 null），以及 moreLenses——约十余个相关镜头。

列出带有某个话题标签的 Snapchat 公开镜头。传入不带 # 的 hashtag（如 music、halloween）。返回 {success, data}，包含归入该标签的镜头，每个镜头都带 lensId，可通过「按镜头 ID 获取详情」展开。

浏览 Snapchat 公开的人脸镜头目录——追踪并改变用户面部的特效（美颜、美妆、面具、变形等）。不传参数获取第一页；传入上次响应中的 cursor 获取下一页。返回 {success, data}，包含人脸镜头条目（lensId、名称、创作者、图片）及分页游标。

浏览 Snapchat 公开的场景（World）镜头目录——通过后置摄像头把 AR 物体放入周围环境，而非作用于人脸的特效。不传参数获取第一页；传入上次响应中的 cursor 继续翻页。返回 {success, data}，包含场景镜头条目及分页游标。

浏览 Snapchat 公开的音乐镜头目录——围绕歌曲或音轨打造的 AR 特效。不传参数获取第一页；传入上次响应中的 cursor 获取下一页。返回 {success, data}，包含音乐镜头条目及分页游标。

浏览 Snapchat 镜头创作者公开名录——AR 镜头背后的开发者与工作室。不传参数获取第一页；传入上次响应中的 cursor 获取更多。返回 {success, data}，包含创作者条目及分页游标；把创作者用户名传给「获取用户发布的镜头」即可列出其作品。