Skip to main content
POST
Bluesky Profile API

Get Bluesky Profiles

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

Request Body

Request Constraints

  • username is required and must contain 1 to 253 ASCII letters, digits, periods, or hyphens, matching ^[A-Za-z0-9.-]{1,253}$.
  • A leading @, underscores, colons, DIDs, profile URLs, empty values, and additional request fields are rejected.
  • Each task accepts one username. user_id, username arrays, results_limit, and a source cursor are not supported.

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
username
string
required

A Bluesky username 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