Snapchat Profile
公开 Snapchat 个人资料可能展示用户名、显示名称、简介、头像、封面、网站、账号标记、地区和可见资料计数。这个定向查询把一个已知用户名转换为标准化账号快照，可用于资料补全、审核或后续比较。
主要特性
- 精确用户名查询每个任务解析一个已知 Snapchat 用户名，可带或不带单个前导 @，不会执行账号搜索。
- 标准化资料身份在 AccountItem 记录中返回可用的用户名、显示名称、简介、公开 URL 和来源标识。
- 资料媒体与上下文将可用头像、封面、网站和地区保留为独立字段，便于展示、索引和资料补全。
- 可见账号信号记录采集时可用的认证与私密标记，以及粉丝数、关注数和帖子数。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
username | 必填 | 必填的 Snapchat 用户名。可以先带一个 @，随后为 1–64 个 ASCII 字母、数字、句点、下划线或连字符；空格、个人主页 URL 和其他字符会被拒绝。 |
如何使用
提交一个符合规则的用户名，等待异步任务完成，再读取标准化个人资料结果。
- 选择一个已知 Snapchat 用户名，主体可包含字母、数字、句点、下划线或连字符，并可带一个前导 @。
- 将 username 提交至 /v1/snapchat/profile，并保留返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务状态变为 succeeded 或 failed。
- 任务成功后读取 data.results.items；这个详情查询通常返回一条个人资料或空列表。
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"zane"}'
# 轮询 GET /v1/tasks/{task_id}
# 任务成功后读取 data.results.items最佳使用场景
- 已知账号资料补全： 为已有 Snapchat 用户名的记录补充公开身份、简介、资料媒体、网站和可用计数。
- 指定个人资料审核： 在统一资料卡或审核队列中呈现一个公开账号，不混入 Stories、Spotlights 或账号管理操作。
- 公开快照对比： 保存每次结果的 collected_at，比较公开资料文本、账号标记、媒体或可见计数随时间的变化。
使用建议
- 请求虽然接受一个前导 @，但建议在自己的记录中统一使用一种规范用户名形式。
- 每个任务只提交一个用户名；批量、个人主页 URL 和 results_limit 都不在该接口契约内。
- 通过语法校验不代表用户名一定能解析为可访问的公开个人资料。
- 网站、地区、资料媒体、账号标记和每项计数都应按选填字段处理。
- 保存每条结果的 collected_at，因为资料文本和可见计数都是采集时快照。
相关 API
需要其他类型的 Snapchat 公开数据时，可以使用以下 API。
- Snapchat Spotlight API — 获取一个已知公开 Snapchat Spotlight，并在来源可用时返回标准化创作者、说明文字、媒体、音频、时间、时长和可见互动字段。
- Snapchat Spotlight Comments API