Bluesky User Posts API
Get Bluesky User Posts
Fetch normalized user posts data from Bluesky.
POST
Bluesky User Posts API
Get Bluesky User Posts
Fetch normalized user posts data from Bluesky. Each successful task costs a fixed0.19 credits.
Request Body
Request Constraints
- Submit at least one of
usernameoruser_id; both non-empty values can be supplied together. usernamemust contain 1 to 253 ASCII letters, digits, periods, or hyphens, matching^[A-Za-z0-9.-]{1,253}$, without a leading@.user_idmust be a DID matching^did:[a-z0-9]+:[A-Za-z0-9._:%-]+$.- Only
usernameanduser_idare 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
limitonGET /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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
- Option 1
- Option 2
A Bluesky decentralized identifier in did:method:identifier form.
Minimum string length:
1Pattern:
^did:[a-z0-9]+:[A-Za-z0-9._:%-]+$A Bluesky handle containing 1 to 253 ASCII letters, digits, periods, or hyphens, without a leading @.
Required string length:
1 - 253Pattern:
^[A-Za-z0-9.-]{1,253}$
