Bluesky Post
Bluesky 帖子是公开发布的内容，可包含正文、作者身份、媒体、时间、话题标签、提及和可见互动数量。将这些信息整理为帖子记录，可以支持 URL 补全、来源审阅、内容研究和分时点互动比较。
主要特性
- 按已知帖子查询将一个公开 bsky.app URL 解析为选定帖子的标准化记录，不扩展为账号帖子流。
- 内容与作者信息集中返回可用的帖子正文、来源 URL、作者身份、附加媒体、话题标签、提及和发布时间。
- 可见互动快照将可用的点赞、评论、转发和观看数量与采集时间一同保留，形成时间点观察记录。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填的非空帖子地址；解析后的主机名必须是 bsky.app 或其子域名。提交校验接受任意 scheme 的绝对地址和协议相对地址。 |
如何使用
提交一个已知的公开 Bluesky 帖子 URL，跟踪异步任务，并通过标准结果信封读取帖子记录。
- 准备一个能够打开目标 Bluesky 帖子的公开 bsky.app URL。
- 将该链接作为 url 提交到 /v1/bluesky/post，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 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最佳使用场景
- 补全已知帖子 URL： 将选定 bsky.app 链接转换为结构化正文、作者、媒体、时间、标签、提及、互动和来源字段。
- 审阅内容与作者归属： 结合帖子正文、作者身份、媒体和公开来源 URL 审阅选定内容，并保留可追溯的作者归属。
- 比较互动观察结果： 将可见互动数量与 collected_at 配对，比较不同采集时点的快照，不将其误解为实时数据流。
使用建议
- 创建任务前确认解析后的主机名是 bsky.app 或其子域名；提交校验不限制 URL scheme，也接受协议相对地址。
- 每个任务只提交一个帖子 URL，并省略 results_limit，因为输入指向一条选定帖子而不是帖子流页面。
- 将帖子正文、作者信息、媒体、话题标签、提及、发布时间和单项互动指标按可空字段处理。
- 保存可见互动数量时一并保存 collected_at，确保后续比较能够还原每次观察的时间。
相关 API
需要其他类型的 Bluesky 公开数据时，可以使用以下 API。
- Bluesky Profile API — 根据经过校验的 username 获取一个公开 Bluesky 主页，返回标准化身份、简介、图片、网站、状态字段、可见账号数量和采集上下文。
- Bluesky User Posts API — 通过 handle 或 DID 采集一页公开 Bluesky 帖子，返回标准化内容、作者、媒体、时间和可见互动指标。