Bluesky 公开数据 API
获取公开 Bluesky 账号、解析指定帖子 URL，或采集一页账号帖子，并返回标准化身份、内容、媒体、时间和可见互动字段。
可用的 Bluesky API
账号数据使用 Profiles，指定公开帖子使用 Posts，按 handle 或 DID 获取一页帖子使用 User Posts。
可以获取哪些 Bluesky 数据？
SocQ 返回标准化公开账号和帖子记录，并保留来源与采集时间信息。
公开账号资料
获取可获得的账号身份、简介、主页图片、网站、账号标记、可见数量和采集时间。
指定帖子内容
将公开 bsky.app URL 解析为帖子身份、正文、作者、媒体、时间、标签和提及信息。
选定账号的帖子
通过不带 @ 的 handle 或有效 Bluesky DID 采集一页公开帖子。
可见互动数据
将可获得的点赞、评论、转发、分享和浏览数量作为时间点快照保留。
SocQ 与 Bluesky 直连集成对比
SocQ 提供异步任务和标准化采集流程；直连集成则需要应用自行处理传输、来源对象、存储和结果投影。
| 能力 | SocQ | 直连集成 |
|---|---|---|
| 主要用途 | 采集公开账号、指定帖子和一页账号帖子 | 构建 provider 原生读取或写入流程 |
| 鉴权 | SocQ API key | 凭据取决于原生方法和服务 |
| 起始输入 | 按接口提交 username、公开帖子 URL、handle 或 DID | 原生标识或方法专用参数 |
| 返回格式 | 标准化 SocQ 记录 | 应用需要自行映射的 provider 原生对象 |
Bluesky API 如何工作
Profiles、Posts 和 User Posts 使用相同的异步任务与已保存结果分页流程。
1. 提交支持的标识
将 username、帖子 URL、handle 或 DID 提交到对应 API，并保存返回的 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到处理成功或失败。
3. 获取结果
读取 data.results.items；仅在已保存结果仍有下一页时继续使用 next_cursor。
使用 SocQ API key 鉴权，并向 User Posts 提交公开 handle。Profiles 和 Posts 使用相同的任务流程。
curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
-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 API 使用场景
账号研究
通过已知 username 补充公开身份、简介、图片、网站、可见指标和采集时间。
指定帖子分析
将选定帖子 URL 解析为标准化内容、作者、媒体、时间、引用、互动和来源字段。
公开账号快照
为已知 handle 或 DID 保存一页帖子，并保留来源时间和采集时间。
互动数据对比
比较多次采集中的可见数量，并将其作为时间点快照使用。
限制与公开数据政策
Bluesky 结果代表采集时可获得的公开字段。这些 API 不访问私密内容，也不发布、修改、删除或管理账号与帖子。
- Profiles 要求一个经过校验的 username，不接受主页 URL。
- Posts 接受一个解析后主机名为 bsky.app 或其子域名的非空地址，包括任意 scheme 的绝对地址和协议相对地址；不采集账号 feed 或回复树。
- User Posts 要求 username 或 user_id；handle 不能带 @，user_id 必须是 DID。
- User Posts 不接受 results_limit 或源站 cursor，并且只采集一个 provider 页面。
- 任务结果上的 cursor 和 limit 只对 SocQ 已保存记录分页，不会继续采集源站页面。
- 来源未提供时，身份、内容、媒体、时间、引用和互动等可选字段可能为空。
Bluesky API 常见问题
Bluesky API 是什么？
Bluesky APIs 用于获取公开账号、解析指定帖子，以及按 handle 或 DID 采集一页公开账号帖子。
应该选择哪个 Bluesky API？
基于 username 获取账号记录使用 Profiles，解析一个已知 bsky.app 帖子 URL 使用 Posts，按 handle 或 DID 获取一页帖子使用 User Posts。
User Posts 会跟随源站 cursor 吗？
不会。它只发送一次 provider 请求并采集一个源站页面；next_cursor 仅用于继续读取 SocQ 已保存的结果记录。
每个字段和指标都一定存在吗？
不一定。标准化结构保持稳定，但依赖来源的身份、内容、媒体、时间、引用和指标值可能为 null。
Bluesky 采集如何计费？
Profiles、Posts 或 User Posts 的每个成功任务均固定消耗 0.19 个 SocQ 积分。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Snapchat API
将一个已知公开 Snapchat Spotlight 获取为标准化记录，并返回可用的创作者、说明文字、媒体、音频、时间、时长和互动字段。
Twitch API
将一个已知公开 Twitch username 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。