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 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。
Apple App Store API
通过已知商店链接采集公开 Apple App Store 应用详情、分类榜单和评价，并返回标准化应用与评价记录。
SEO API
查询实时 Google 自然搜索结果，比较关键词需求和排名难度，扩展种子词，找出带来网站搜索可见性的关键词与页面，并识别搜索意图。所有接口共用 SocQ API Key、异步任务流程和标准化结果格式。
Amazon API
从受支持的 Amazon 站点搜索公开商品，并采集标准化的商品详情、畅销榜、评价和卖家资料记录。
Douyin API
获取公开账号和视频，搜索视频，采集一页评论或创作者视频，并查询已知直播间。