万有引擎
搜索⌘K
中文
登录免费开始
Snapchat

Snapchat API

按 Snapchat 公开账号查看主页、Stories 中的 Snap 与 Spotlight 视频，分别保留故事归属和视频互动数据，便于整理创作者公开内容。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 snapchat，action 填下方列表里的能力名，例如 profile。

  • 4 个能力
  • $1.39 / 千次
  • 失败和空结果都不收费
免费开始 文档

平台运行状态

24h 健康值
正常
正常

30 天趋势

Snapchat 能力清单

能力做什么单价空白行均为 $1.39 / 千次24 小时运行状态 · 全部正常
主页或对象详情profileprofile 面向公开主页，区别于仅好友可见的个人档案，也不能自动把公开主页认成企业账号。正常
Stories 内容storiesstories 每行是一条 Snap，不是一整个 Story，也不是账号的永久故事档案。正常
用户内容user_postsuser_posts 在这里专指 Spotlight 列表，不是所有 Snaps、聊天附件或 Story 的合集。正常
视频详情videovideo 使用具体 Spotlight 地址，适合把发现的短视频关联回创作者与原始页面。正常

Snapchat 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价空白行均为 $1.39 / 千次返回字段
profileusername——business_profile_id · username · display_name · bio · profile_type · category · subcategory · subscriber_count · is_verified · website · address · has_story · lens_count · highlight_count · spotlight_count · url · avatar_url · snapcode_url · hero_image_url · created_at · platform · related_accounts
storiesusername——id · story_id · story_title · media_url · thumbnail_url · posted_at · username · author_name · author_url · platform
user_postsusername——id · url · title · text · summary · caption · media_url · thumbnail_url · duration_ms · width · height · view_count · share_count · comment_count · boost_count · recommend_count · posted_at · username · author_name · author_url · platform
videourlspotlight_url—id · url · text · hashtags · view_count · share_count · duration_ms · posted_at · thumbnail_url · media_url · username · author_name · author_url · author_avatar_url · platform

怎么调用 Snapchat 主页或对象详情 API？

profile

使用 platform="snapchat"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 business_profile_id、username、display_name、bio、profile_type、category 等 22 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Snapchat profile 的参数分别是什么意思？

username必填
公开创作者账号短名，可写 @用户名，或 snapchat.com/add/用户名、snapchat.com/@用户名 链接。profile 取公开资料，stories 取当前公开故事，user_posts 取 Spotlight 短视频；不读取私聊或仅好友可见故事。

官方区分公开主页与个人档案，并说明拥有 Public Profile 不自动成为 Business Profile 或 Snap Star。用于解释账号对象和资格边界，不把网页功能全部当成本接口能力。官方来源：Snapchat：Public Profile、Business Profile 与 Snap Star 不同来源核查：

Snapchat 返回字段与含义（10）
profile_type
账号类型（个人/公众人物/企业）。
business_profile_id
企业账号 ID。
subscriber_count
订阅者数。
snapcode_url
Snapcode 图片（扫码关注用的黄色码）。
hero_image_url
主页头图。
has_story
当前是否有可看的 Story。
highlight_count
精选集数量。
spotlight_count
Spotlight（短视频流）作品数。
lens_count
滤镜(Lens)数量。创作者账号的核心产出指标之一。
subcategory
子分类。

怎么调用 Snapchat Stories 内容 API？

stories

使用 platform="snapchat"、action="stories" 调用“Stories 内容”能力；返回列表，主要包含 id、story_id、story_title、media_url、thumbnail_url、posted_at 等 10 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Snapchat stories 的参数分别是什么意思？

username必填
公开创作者账号短名，可写 @用户名，或 snapchat.com/add/用户名、snapchat.com/@用户名 链接。profile 取公开资料，stories 取当前公开故事，user_posts 取 Spotlight 短视频；不读取私聊或仅好友可见故事。

官方明确活跃 Public Stories 可从主页查看，而 My Story · Friends 仅好友可见。EveryInfra 只说明当前公开故事范围，不承诺读取好友故事或历史过期资产。官方来源：Snapchat：公开 Story 与仅好友可见 Story 的边界来源核查：

Snapchat 返回字段与含义（3）
media_url
媒体链接。
story_id
Story ID。
story_title
Story 标题。

怎么调用 Snapchat 用户内容 API？

user_posts

使用 platform="snapchat"、action="user_posts" 调用“用户内容”能力；返回列表，主要包含 id、url、title、text、summary、caption 等 21 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Snapchat user_posts 的参数分别是什么意思？

username必填
公开创作者账号短名，可写 @用户名，或 snapchat.com/add/用户名、snapchat.com/@用户名 链接。profile 取公开资料，stories 取当前公开故事，user_posts 取 Spotlight 短视频；不读取私聊或仅好友可见故事。

官方将 Spotlight 解释为集中发现社区 Snaps 的入口，也有网页观看入口。该链接解释内容类型，不意味着本接口开放 Spotlight 搜索、上传或所有趋势筛选。官方来源：Spotlight 是 Snapchat 的独立公开内容入口来源核查：

Snapchat 返回字段与含义（8）
media_url
媒体链接。
caption
内容文字说明。
summary
摘要。
duration_ms
时长，单位毫秒（除以 1000 才是秒）。
width
媒体宽度，像素。
height
媒体高度，像素。
boost_count
推广加成数。
recommend_count
被推荐次数。

怎么调用 Snapchat 视频详情 API？

video

使用 platform="snapchat"、action="video" 调用“视频详情”能力；返回单个对象，主要包含 id、url、text、hashtags、view_count、share_count 等 15 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

官方区分开始观看次数 Views、独立观看者 Viewers、分享与评论。EveryInfra view_count 不应改写为独立观看人数；后台观看时长、受众画像及授权分享的额外指标不在该接口承诺内。官方来源：Snapchat Spotlight：Views 与唯一 Viewers 要分开来源核查：

Snapchat video 的参数分别是什么意思？

url必填
video 使用具体 Spotlight 视频链接，不能用 add/ 账号链接代替视频；在账号接口中仅作为用户名解析的兼容输入。
spotlight_url可选
video 的 Spotlight 链接兼容输入，低于 url 优先级；公开请求仍应填写 url。
Snapchat 返回字段与含义（4）
media_url
媒体链接。
duration_ms
时长，单位毫秒（除以 1000 才是秒）。
hashtags
话题标签。
author_avatar_url
作者头像。
Snapchat profile 调用流程一次 Snapchat profile 调用的全过程：向 POST /api/v1/social 发送 platform="snapchat"、action="profile"，以及必填参数 username;返回结构化 JSON，含 business_profile_id、username、display_name、bio、profile_type 等字段；返回单个对象，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "snapchat"action: "profile"usernameEveryInfra$1.39 / 千次2 · 响应 · 对象business_profile_idusernamedisplay_namebioprofile_type
一次 Snapchat profile 调用的全过程：向 POST /api/v1/social 发送 platform="snapchat"、action="profile"，以及必填参数 username;返回结构化 JSON，含 business_profile_id、username、display_name、bio、profile_type 等字段；返回单个对象，计费 $1.39 / 千次，失败与空结果不计费。

Snapchat 原始字段名

EveryInfra 统一字段名

左边是 Snapchat 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Snapchat 的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 11 个字段名只在 Snapchat 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • business_profile_id
  • profile_type
  • subcategory
  • has_story
  • lens_count
  • spotlight_count
  • snapcode_url
  • hero_image_url
  • related_accounts
  • story_id
  • story_title

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

business_profile_id
企业账号 ID。
username
用户名（@handle）。
display_name
显示名，可能与 username 不同。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
profile_type
账号类型（个人/公众人物/企业）。
category
分类名称，取值为原平台的分类体系，未做跨平台归一。
subcategory
子分类。
subscriber_count
订阅者数。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
website
账号或商家填写的外链网址。
address
详细地址，原文透传。
has_story
当前是否有可看的 Story。
lens_count
滤镜(Lens)数量。创作者账号的核心产出指标之一。
highlight_count
精选集数量。
spotlight_count
Spotlight（短视频流）作品数。
url
该记录在原平台上的可访问链接。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
snapcode_url
Snapcode 图片（扫码关注用的黄色码）。
hero_image_url
主页头图。
created_at
创建时间，格式同 posted_at。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
story_id
Story ID。
story_title
Story 标题。
media_url
媒体链接。
thumbnail_url
缩略图链接，分辨率低于 image_url。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
author_name
作者昵称（显示名）。
author_url
作者在原平台的主页链接。
title
标题。平台无标题概念时（如纯文本帖）为 null。
text
正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
summary
摘要。
caption
内容文字说明。
duration_ms
时长，单位毫秒（除以 1000 才是秒）。
width
媒体宽度，像素。
height
媒体高度，像素。
view_count
浏览/播放数。null 表示不公开，不等于 0。
share_count
分享/转发数。null 表示不公开，不等于 0。
comment_count
评论数。null 表示不公开，不等于 0。
boost_count
推广加成数。
recommend_count
被推荐次数。
hashtags
话题标签。
author_avatar_url
作者头像。

当前目录另列出 related_accounts，这些字段尚无逐项释义；请先核对 Snapchat 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

替换为公开账号用户名，不是显示昵称或 Snap 链接。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

snapchat_profile.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"snapchat","action":"profile","params":{"username":"<SNAPCHAT_USERNAME>"}}'

记录字段预览（非真实响应）

仅展示 profile 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "business_profile_id": null,
  "username": null,
  "display_name": null,
  "bio": null,
  "profile_type": null,
  "category": null,
  "subcategory": null,
  "subscriber_count": null,
  "is_verified": null,
  "website": null,
  "address": null,
  "has_story": null,
  "lens_count": null,
  "highlight_count": null,
  "spotlight_count": null,
  "url": null,
  "avatar_url": null,
  "snapcode_url": null,
  "hero_image_url": null,
  "created_at": null,
  "platform": null,
  "related_accounts": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

核对 Snapchat Public Profile 的公开资料与内容类型

profile 面向公开主页，区别于仅好友可见的个人档案，也不能自动把公开主页认成企业账号。

查看 profile 的 username 参数
  • username 可传账号短名、@短名，或完整 https://www.snapchat.com/add/<username>、https://www.snapchat.com/@<username> 链接。<username> 只是格式占位符；display_name 是显示名，不应拿来代替账号定位。
  • subscriber_count 是订阅者计数，lens_count、highlight_count、spotlight_count 分别是 Lens、精选集与 Spotlight 数量，has_story 仅表示返回时的故事状态。profile_type / business_profile_id 不构成企业身份或 Snap Star 资质保证；未返回的计数和可选资产不能自行补齐。

按 Snapchat 账号读取当前公开 Story 中的 Snaps

stories 每行是一条 Snap，不是一整个 Story，也不是账号的永久故事档案。

查看 stories 的 username 参数
  • username 定位公开创作者账号。相同 story_id 下可能有多条 Snap，各自有 id、media_url、thumbnail_url 和 posted_at；应先按 story_id 分组，再使用 story_title 展示故事名称。
  • 当前只取公开主页可读的故事，不读取 My Story · Friends、私聊或已过期的完整历史。返回媒体链接不代表拥有再分发许可；本入口也不提供观看者名单、故事回复正文或创作者后台的受众画像。

整理 Snapchat 账号的 Spotlight 短视频及互动计数

user_posts 在这里专指 Spotlight 列表，不是所有 Snaps、聊天附件或 Story 的合集。

查看 user_posts 的 username 参数
  • username 选择账号，返回 id / url 定位具体 Spotlight。text 是描述，caption 是画面内文字说明；title / summary 可能是生成式整理文本，不应直接署名为创作者原题或原话，引用时应优先核对原始描述与视频。
  • duration_ms 以毫秒计，width / height 以像素计。view_count、share_count、comment_count 分别为播放、分享与评论计数，不是独立观看人数或评论正文；boost_count / recommend_count 暂不用于推导付费推广、推荐曝光或官方统一指标。

从 Spotlight 视频链接核对单条内容

video 使用具体 Spotlight 地址，适合把发现的短视频关联回创作者与原始页面。

查看 video 的 url 参数
  • url 必须是具体 Spotlight 视频链接，不要传 add/ 主页链接或故事标题；spotlight_url 是兼容输入，公开请求仍需 url。返回 id 从 Spotlight 链接定位，username / author_url 指向创作者，而不是观看或分享该视频的人。
  • text、hashtags、posted_at、duration_ms 和 view_count / share_count 描述该条视频；本入口不提供评论列表、完整推荐轨迹或创作者收入。media_url 仅是返回的媒体地址，公开播放不等于下载、二次商用或永久保存授权。

Snapchat API 常见问题

Snapchat API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="snapchat"、action 和 params。以 profile 为例，必填 username，没有可选参数。替换为公开账号用户名，不是显示昵称或 Snap 链接。 Snapchat 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Snapchat API 怎么收费？

$1.39 / 千次，Snapchat 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Snapchat 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Snapchat API 一次能返回多少条数据？

Snapchat 有 2 个列表接口，包括 stories、user_posts。其余 2 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Snapchat API 返回哪些字段？

当前目录为 profile 列出 business_profile_id、username、display_name、bio、profile_type、category 等 22 个字段名。按全站当前目录统计，11 个字段名只在 Snapchat 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「核对 Snapchat Public Profile 的公开资料与内容类型」怎样接入 Snapchat API？

profile 面向公开主页，区别于仅好友可见的个人档案，也不能自动把公开主页认成企业账号。 username 可传账号短名、@短名，或完整 https://www.snapchat.com/add/<username>、https://www.snapchat.com/@<username> 链接。<username> 只是格式占位符；display_name 是显示名，不应拿来代替账号定位。 subscriber_count 是订阅者计数，lens_count、highlight_count、spotlight_count 分别是 Lens、精选集与 Spotlight 数量，has_story 仅表示返回时的故事状态。profile_type / business_profile_id 不构成企业身份或 Snap Star 资质保证；未返回的计数和可选资产不能自行补齐。

「按 Snapchat 账号读取当前公开 Story 中的 Snaps」怎样接入 Snapchat API？

stories 每行是一条 Snap，不是一整个 Story，也不是账号的永久故事档案。 username 定位公开创作者账号。相同 story_id 下可能有多条 Snap，各自有 id、media_url、thumbnail_url 和 posted_at；应先按 story_id 分组，再使用 story_title 展示故事名称。 当前只取公开主页可读的故事，不读取 My Story · Friends、私聊或已过期的完整历史。返回媒体链接不代表拥有再分发许可；本入口也不提供观看者名单、故事回复正文或创作者后台的受众画像。

「整理 Snapchat 账号的 Spotlight 短视频及互动计数」怎样接入 Snapchat API？

user_posts 在这里专指 Spotlight 列表，不是所有 Snaps、聊天附件或 Story 的合集。 username 选择账号，返回 id / url 定位具体 Spotlight。text 是描述，caption 是画面内文字说明；title / summary 可能是生成式整理文本，不应直接署名为创作者原题或原话，引用时应优先核对原始描述与视频。 duration_ms 以毫秒计，width / height 以像素计。view_count、share_count、comment_count 分别为播放、分享与评论计数，不是独立观看人数或评论正文；boost_count / recommend_count 暂不用于推导付费推广、推荐曝光或官方统一指标。

「从 Spotlight 视频链接核对单条内容」怎样接入 Snapchat API？

video 使用具体 Spotlight 地址，适合把发现的短视频关联回创作者与原始页面。 url 必须是具体 Spotlight 视频链接，不要传 add/ 主页链接或故事标题；spotlight_url 是兼容输入，公开请求仍需 url。返回 id 从 Spotlight 链接定位，username / author_url 指向创作者，而不是观看或分享该视频的人。 text、hashtags、posted_at、duration_ms 和 view_count / share_count 描述该条视频；本入口不提供评论列表、完整推荐轨迹或创作者收入。media_url 仅是返回的媒体地址，公开播放不等于下载、二次商用或永久保存授权。

可以先免费试用 Snapchat API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择 Snapchat 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 106 平台 ↗

开始调用 Snapchat API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个 Snapchat 接口验证结果。

免费开始

自有访问统计常开；Google Analytics 仅在你点「同意分析」后启用。 隐私政策