bluesky/
profile

通过经过校验的 username 获取一个公开 Bluesky 主页,返回标准化身份、简介、主页图片、网站和可见账号数量,并通过一次异步任务提供结果。

Bluesky Profile API

username 格式校验
主页身份与图片
可见账号数量
每次请求 0.19 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Bluesky Profile

Bluesky 主页是包含持久标识、handle、显示名称、简介、主页图片、网站以及可见粉丝数、关注数和帖子数的公开账号记录。这些身份字段与账号信号可用于补全主页资料、比较公开账号和观察不同时点的变化。

Bluesky Profile API 主要特性

  • 按 username 直接查找将一个由 1 到 253 个字母、数字、点或连字符组成的 username 解析为公开主页记录。
  • 标准化主页身份以一致账号结构返回可用主页 ID、来源 URL、username、显示名称、简介和关联网站。
  • 主页图片与状态字段将可用头像、封面、认证和隐私状态保留为可空字段,不在来源缺失时自行补值。
  • 可见账号数量快照将可用粉丝数、关注数和帖子数与 collected_at 一同保留,使每次公开账号快照都有观察时间。

Bluesky Profile API 参数

参数必填描述
username必填必填的公开 Bluesky username,由 1 到 253 个字母、数字、点或连字符组成。不要提交开头的 @、下划线、DID、主页 URL 或第二个 username。

如何使用 Bluesky Profile API

提交一个经过校验的 username,跟踪异步任务,并从标准结果响应中读取主页记录。

  1. 准备一个由字母、数字、点或连字符组成的 Bluesky username,例如 jay.bsky.team,不要添加开头的 @。
  2. 将 username 提交到 /v1/bluesky/profile,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或返回失败。
  4. 从 data.results.items 读取结果。该查找通常只保存一个主页,因此 has_more 为 false;若通用结果响应报告更多数据,则使用 next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/bluesky/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"jay.bsky.team"}'

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取主页记录

Bluesky Profile API 最佳使用场景

  • 已知主页资料补全: 根据已有 Bluesky username,为记录补充公开 handle、显示名称、简介、主页图片、网站和来源 URL。
  • 账号规模比较: 分别提交多个 username,并使用相同的标准化指标键比较可用粉丝数、关注数和帖子数。
  • 主页展示监测: 在重复任务中保存身份、简介、图片、网站和 collected_at,用于识别不同公开快照之间的变化。

Bluesky Profile API 使用建议

  • 提交前去掉开头的 @,并按字母、数字、点和连字符校验剩余 username;此 endpoint 不接受 user_id,因此应拒绝 DID。
  • 优先使用返回的 id 对主页去重;id 为空时,再使用 url 或 username 作为备用键。
  • 允许简介、头像、封面、网站、状态、地点和单项指标为 null,避免部分公开字段缺失时中断结果处理。
  • 不要添加 results_limit 或 username 数组;每个 username 作为一个固定价格任务提交,并将正常结果视为单条主页记录。

除了 Bluesky Profile API,需要其他类型的 Bluesky 公开数据时,可以使用以下 API。

  • Bluesky Post API — 将一个已知的公开 bsky.app 帖子 URL 解析为标准化正文、作者、媒体、时间、标签、提及和可见互动字段。
  • Bluesky User Posts API — 通过 handle 或 DID 采集一页公开 Bluesky 帖子,返回标准化内容、作者、媒体、时间和可见互动指标。

探索其他平台

还可以将 Bluesky 数据与其他已支持社交平台的公开数据结合使用。

Bluesky Profile API — 常见问题

Bluesky Profile API 是一个用于根据经过校验的 username 获取单个公开 Bluesky 主页的 API。它返回标准化身份、简介、主页图片、网站、可选状态字段、可见账号数量和采集时间。

提交由 1 到 253 个字母、数字、点或连字符组成的值,不要添加开头的 @。下划线、冒号、主页 URL、DID、空值和额外请求字段会被拒绝。

标准账号记录包含身份与来源字段、username、显示名称、简介、头像、封面、网站、认证与隐私状态、可选地点、粉丝数、关注数、帖子数和采集时间。无法获得的选填字段保留为 null。

不支持。每个任务接受一个 username,通常最多返回一条主页记录,不接受 results_limit 或调用方控制的输入 cursor;任务结果仍使用标准 next_cursor 和 has_more 响应字段。

每个成功任务固定消耗 0.19 个 SocQ credits。该请求只执行一次主页查找,费用不会随结果数量变化。