怎么调用 Bluesky 主页或对象详情 API？
profile使用 platform="bluesky"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 banner_url、follower_count、following_count、post_count。
username必填- 账号用户名（@handle），不带 @ 前缀。
Bluesky 特有返回字段与含义（1）
- banner_url
- 主页横幅图。
Bluesky 能力清单
| action | 必填参数 | 可选参数 | 单次条数 | 模式 | 单价 / 次 | 返回字段 |
|---|---|---|---|---|---|---|
| profile | username | — | — | 同步 | $1.39 / 千次 | banner_url · follower_count · following_count · post_count |
| user_posts | username | — | 默认 20 · 最多 200 | 同步 | $1.39 / 千次 | id · url · text · author_username · author_name · author_id · author_avatar_url · lang · like_count · repost_count · comment_count · quote_count · bookmark_count · is_reply · is_repost · posted_at · platform |
| followers | username | — | 默认 30 · 最多 100 | 同步 | $1.39 / 千次 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
| following | username | — | 默认 30 · 最多 100 | 同步 | $1.39 / 千次 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
| search_people | keyword | — | 默认 20 · 最多 200 | 同步 | $1.39 / 千次 | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
Bluesky 每个接口分别做什么
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 只需切换 action。
怎么调用 Bluesky 用户内容 API？
user_posts使用 platform="bluesky"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、text、author_username、author_name、author_id 等 17 个字段。
username必填- 账号用户名（@handle），不带 @ 前缀。
Bluesky 特有返回字段与含义（6）
- author_avatar_url
- 作者头像。
- is_reply
- 是否为回复。
- is_repost
- 是否为转发。
- quote_count
- 引用转发数。与 repost 不同：引用是带评论的转发。
- bookmark_count
- 收藏数。
- lang
- 内容语言，作者发布时自行标注。
怎么调用 Bluesky 粉丝列表 API？
followers使用 platform="bluesky"、action="followers" 调用“粉丝列表”能力；返回列表，默认 30 条、单次最多 100 条，主要包含 user_id、username、display_name、bio、url、avatar_url 等 10 个字段。
username必填- 账号用户名（@handle），不带 @ 前缀。
Bluesky 特有返回字段与含义（2）
- joined_at
- 账号注册时间。
- source_username
- 转发来源账号。
怎么调用 Bluesky 关注列表 API？
following使用 platform="bluesky"、action="following" 调用“关注列表”能力；返回列表，默认 30 条、单次最多 100 条，主要包含 user_id、username、display_name、bio、url、avatar_url 等 10 个字段。
username必填- 账号用户名（@handle），不带 @ 前缀。
Bluesky 特有返回字段与含义（2）
- joined_at
- 账号注册时间。
- source_username
- 转发来源账号。
怎么调用 Bluesky 人员搜索 API？
search_people使用 platform="bluesky"、action="search_people" 调用“人员搜索”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 user_id、username、display_name、bio、url、avatar_url 等 10 个字段。
keyword必填- 检索关键词。
Bluesky 特有返回字段与含义（2）
- joined_at
- 账号注册时间。
- source_username
- 转发来源账号。
Bluesky 原始字段名
EveryInfra 统一字段名
左边是 Bluesky 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段， 解析代码一行不用动。
只有 Bluesky 返回的字段
全站 87 个平台里，这 3 个字段只有 Bluesky 会返回——换别的平台拿不到这些数据。 字段名与其余平台同样遵循 snake_case 命名，解析方式一致。
- lang
- bookmark_count
- source_username
返回字段含义
字段名跨 87 个平台统一，同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。 机器可读版:/api/v1/social/fields
- follower_count
- 粉丝数。null 表示不公开，不等于 0。
- following_count
- 关注数。null 表示不公开，不等于 0。
- post_count
- 发布内容总数。null 表示不公开，不等于 0。
- id
- 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
- url
- 该记录在原平台上的可访问链接。
- text
- 正文内容，已去除 HTML 标签。长文可能被截断。
- author_username
- 作者用户名（@handle），通常可用于拼 URL。
- author_name
- 作者昵称（显示名）。
- author_id
- 作者在原平台的唯一 ID。
- like_count
- 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
- repost_count
- 转发数（区别于引用转发）。null 表示不公开。
- comment_count
- 评论数。null 表示不公开，不等于 0。
- posted_at
- 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
- platform
- 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
- user_id
- 用户在原平台的唯一 ID。
- username
- 用户名（@handle）。
- display_name
- 显示名，可能与 username 不同。
- bio
- 个人简介，账号自己填写的文本。可能含换行和 emoji。
- avatar_url
- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
- is_verified
- 是否为平台认证账号（蓝V等）。null 表示无法判定。
另有 Bluesky 特有字段 banner_url · author_avatar_url · lang · quote_count · bookmark_count · is_reply · is_repost · joined_at · source_username，保留该平台自身的语义。
30 秒调用示例
bluesky_profile.sh
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer omg_你的KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bluesky","action":"profile","params":{"username":"<username>"}}'
返回长这样
response.json
{ "id": "bluesky_…", "profile": [ { "banner_url": "https://…", "follower_count": 128, "following_count": 128, "post_count": 128 } ], "count": 1, "billing": { "charged": true, "credits": 100, "cny": 0.009356 } }
常见用例
账号与主体画像
按 Bluesky 的主页数据建达人/商家档案，做投放筛选或竞品盯防。
内容追踪
持续拉取指定账号在 Bluesky 的历史与新增内容，做选题与节奏分析。
粉丝与关系链
拉 Bluesky 的粉丝/关注列表，做受众画像与增长归因。
Bluesky API 常见问题
Bluesky API 怎么调用?
调 POST /api/v1/social,请求体传 platform="bluesky"、action 和 params。以 profile 为例,必填 username,没有可选参数。Bluesky 共 5 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。
Bluesky API 怎么收费?
$1.39 / 千次/次,Bluesky 全部 5 个能力同价。$1 免费额度约等于 719 次 Bluesky 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。
Bluesky API 一次能返回多少条数据?
最多的是 user_posts,单次上限 200 条(默认 20 条)。另外 1 个能力返回单个对象,没有条数概念。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。
Bluesky API 返回哪些字段?
profile 返回 banner_url、follower_count、following_count、post_count。其中 3 个字段只有 Bluesky 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。
Bluesky账号资料怎么批量抓取?
调 POST /api/v1/social,传 platform="bluesky"、action="profile",必填参数 username。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,账号资料字段为 banner_url、follower_count、following_count、post_count。
怎么批量抓取Bluesky某个账号的全部内容?
调 POST /api/v1/social,传 platform="bluesky"、action="user_posts",必填参数 username。单次最多 200 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,账号内容字段为 id、url、text、author_username、author_name。
Bluesky粉丝列表怎么批量导出?
调 POST /api/v1/social,传 platform="bluesky"、action="followers",必填参数 username。单次最多 100 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,粉丝列表字段为 user_id、username、display_name、bio、url。
可以先免费试用 Bluesky API 吗?
可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 Bluesky 的 5 个能力都试一遍。无需信用卡。
开始调用 Bluesky API
加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 Bluesky 的能力全试一遍。