bluesky/
post

通过已知 bsky.app URL 采集一条公开 Bluesky 帖子,返回正文、作者身份、媒体、时间、话题标签、提及和可见互动指标。

Bluesky Post API

单个帖子 URL
作者信息
互动快照
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Bluesky Post

Bluesky 帖子是公开发布的内容,可包含正文、作者身份、媒体、时间、话题标签、提及和可见互动数量。将这些信息整理为帖子记录,可以支持 URL 补全、来源审阅、内容研究和分时点互动比较。

Bluesky Post API 主要特性

  • 按已知帖子查询将一个公开 bsky.app URL 解析为选定帖子的标准化记录,不扩展为账号帖子流。
  • 内容与作者信息集中返回可用的帖子正文、来源 URL、作者身份、附加媒体、话题标签、提及和发布时间。
  • 可见互动快照将可用的点赞、评论、转发和观看数量与采集时间一同保留,形成时间点观察记录。

Bluesky Post API 参数

参数必填描述
url必填必填的非空帖子地址;解析后的主机名必须是 bsky.app 或其子域名。提交校验接受任意 scheme 的绝对地址和协议相对地址。

如何使用 Bluesky Post API

提交一个已知的公开 Bluesky 帖子 URL,跟踪异步任务,并通过标准结果信封读取帖子记录。

  1. 准备一个能够打开目标 Bluesky 帖子的公开 bsky.app URL。
  2. 将该链接作为 url 提交到 /v1/bluesky/post,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或返回失败。
  4. 读取 data.results.items;仅当结果信封中的 has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;仅在 has_more 为 true 时继续使用 next_cursor

Bluesky Post API 最佳使用场景

  • 补全已知帖子 URL: 将选定 bsky.app 链接转换为结构化正文、作者、媒体、时间、标签、提及、互动和来源字段。
  • 审阅内容与作者归属: 结合帖子正文、作者身份、媒体和公开来源 URL 审阅选定内容,并保留可追溯的作者归属。
  • 比较互动观察结果: 将可见互动数量与 collected_at 配对,比较不同采集时点的快照,不将其误解为实时数据流。

Bluesky Post API 使用建议

  • 创建任务前确认解析后的主机名是 bsky.app 或其子域名;提交校验不限制 URL scheme,也接受协议相对地址。
  • 每个任务只提交一个帖子 URL,并省略 results_limit,因为输入指向一条选定帖子而不是帖子流页面。
  • 将帖子正文、作者信息、媒体、话题标签、提及、发布时间和单项互动指标按可空字段处理。
  • 保存可见互动数量时一并保存 collected_at,确保后续比较能够还原每次观察的时间。

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

  • Bluesky Profile API — 根据经过校验的 username 获取一个公开 Bluesky 主页,返回标准化身份、简介、图片、网站、状态字段、可见账号数量和采集上下文。
  • Bluesky User Posts API — 通过 handle 或 DID 采集一页公开 Bluesky 帖子,返回标准化内容、作者、媒体、时间和可见互动指标。

探索其他平台

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

Bluesky Post API — 常见问题

Bluesky Post API 是一个用于从已知帖子 URL 获取一条公开 Bluesky 帖子的 API。它返回标准化正文、作者身份、媒体、时间、话题标签、提及和可见互动数量。

提交一个解析后主机名为 bsky.app 或其子域名的非空地址。后端接受任意 scheme 的绝对地址和协议相对地址;请求只接受 url 字段。

帖子结构包含身份和来源字段、正文、发布时间与采集时间、作者信息、媒体、话题标签、提及,以及可用的点赞、评论、转发和观看数量。公开来源没有提供可用值时,对应可空字段会保持为空。

不会。结果代表选定帖子,可以包含可见的 comments_count,但帖子结构不返回独立回复记录或回复树。

不可以。请求通过一个 url 解析一条帖子,不接受 results_limit;请通过标准任务结果信封读取返回项。

每个成功的 Bluesky Post 任务固定消耗 0.19 SocQ 积分,费用不随请求或返回的结果数量变化。