Skip to main content
POST
Bluesky Post API

Get Bluesky Posts

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

Request Body

Request Constraints

  • url is required and must be a non-empty string whose parsed hostname is bsky.app or a bsky.app subdomain.
  • Validation accepts references using any scheme when they include an authority and hostname, plus protocol-relative references such as //bsky.app/...; opaque or hostless values and other domains are rejected.
  • Submission validation does not enforce a post-specific path. A reference that does not resolve to a supported public post can still fail during provider execution.
  • The request accepts only url. results_limit, a source cursor, and additional request fields 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
url
string
required

A non-empty post reference with an authority component whose parsed hostname is bsky.app or a bsky.app subdomain. Any scheme is accepted when an authority and hostname are present; protocol-relative references are also accepted.

Minimum string length: 1

Response

Task accepted

code
integer
data
object