Skip to main content
POST
Bluesky User Posts API

Get Bluesky User Posts

Fetch normalized user posts data from Bluesky. Each successful task costs a fixed 0.19 credits.

Request Body

Request Constraints

  • Submit at least one of username or user_id; both non-empty values can be supplied together.
  • username must contain 1 to 253 ASCII letters, digits, periods, or hyphens, matching ^[A-Za-z0-9.-]{1,253}$, without a leading @.
  • user_id must be a DID matching ^did:[a-z0-9]+:[A-Za-z0-9._:%-]+$.
  • Only username and user_id are accepted. results_limit, a source cursor, and additional request fields are rejected.
  • Provider collection does not follow source pagination and saves records only from the first returned source page. Cursor and limit on GET /v1/tasks/{task_id} only paginate saved records; the read limit is 1 to 500.

Use with MCP

A successful request returns a task_id. Poll it with socq_get_task, then read normalized records from results.items.

Result Fields

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
user_id
string
required

A Bluesky decentralized identifier in did:method:identifier form.

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

A Bluesky handle containing 1 to 253 ASCII letters, digits, periods, or hyphens, without a leading @.

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

Response

Task accepted

code
integer
data
object