Skip to main content
POST
Bluesky User Posts

Bluesky User Posts

获取 Bluesky 的标准化公开 User Posts 数据。 每个成功任务固定扣除 0.19 积分。

请求体

请求限制

  • usernameuser_id 至少提交一个,也可以同时提交两个非空值。
  • username 必须由 1 到 253 个 ASCII 字母、数字、点或连字符组成,匹配 ^[A-Za-z0-9.-]{1,253}$,且不能以 @ 开头。
  • user_id 必须是匹配 ^did:[a-z0-9]+:[A-Za-z0-9._:%-]+$ 的 DID。
  • 请求只接受 usernameuser_idresults_limit、源站 cursor 和其他额外字段都会被拒绝。
  • Provider 采集不会跟随源站分页,只保存首次返回源站页面中的记录。GET /v1/tasks/{task_id} 上的 cursor 和 limit 仅对已保存记录分页,读取 limit 范围为 1 到 500。

通过 MCP 使用

请求成功后会返回 task_id。使用 socq_get_task 查询任务,成功后从 results.items 读取标准化结果。

结果字段

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json
user_id
string
必填

采用 did:method:identifier 格式的 Bluesky 去中心化标识符。

Minimum string length: 1
Pattern: ^did:[a-z0-9]+:[A-Za-z0-9._:%-]+$
username
string

由 1 到 253 个 ASCII 字母、数字、点或连字符组成,且不带开头 @ 的 Bluesky handle。

Required string length: 1 - 253
Pattern: ^[A-Za-z0-9.-]{1,253}$

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object