bluesky/
post

The Bluesky Post API collects one public post from a known bsky.app URL, returning text, author identity, media, timestamps, hashtags, mentions, and visible engagement.

Bluesky Post API

Single post URL
Author context
Engagement snapshot
0.19 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Bluesky Post

Bluesky posts are public publications with text, author identity, media, timestamps, hashtags, mentions, and visible engagement counts. These records support URL enrichment, source review, content research, and time-stamped engagement comparison.

Bluesky Post API Features

  • Known post lookupThe Bluesky Post API resolves one public bsky.app URL into the normalized record for that selected post rather than expanding an account feed.
  • Content and author contextReturn available post text, source URL, author identity, attached media, hashtags, mentions, and publication time together.
  • Visible engagement snapshotKeep available like, comment, repost, and view counts with the collection time for a point-in-time observation.

Bluesky Post API Parameters

ParametersRequiredDescription
urlRequiredRequired non-empty post reference whose parsed hostname is bsky.app or a bsky.app subdomain. The submission validator accepts absolute references with any scheme and protocol-relative references.

How to Use the Bluesky Post API

Submit a known public post URL to the Bluesky Post API, follow the asynchronous task, and read the normalized result through the standard result envelope.

  1. Prepare one public bsky.app URL that resolves to the Bluesky post you want to inspect.
  2. Submit the URL as url to /v1/bluesky/post and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
  4. Read data.results.items; follow next_cursor only when the result envelope reports has_more as true.
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is true

Bluesky Post API Use Cases

  • Enrich a known post URL: Convert a selected bsky.app link into structured text, author, media, timestamp, tag, mention, metric, and source fields.
  • Review content and attribution: Use post text, author identity, media, and the public source URL to examine a selected publication with traceable attribution.
  • Compare engagement observations: Pair visible engagement counts with collected_at to compare separately collected snapshots without treating them as a live stream.

Bluesky Post API Pro Tips

  • Confirm that the parsed hostname is bsky.app or a bsky.app subdomain. The submission validator does not restrict the URL scheme and also accepts protocol-relative references.
  • Use one post URL per task and omit results_limit because the input identifies one selected post rather than a feed page.
  • Treat post text, author details, media, hashtags, mentions, publication time, and individual metrics as nullable fields.
  • Store collected_at with visible engagement counts so later comparisons preserve when each observation was made.

Beyond the Bluesky Post API, use these APIs when you need a different type of public Bluesky data.

  • Bluesky Profile API — Retrieve one public Bluesky profile from a validated username with normalized identity, biography, imagery, website, status fields, visible account counts, and collection context.
  • Bluesky User Posts API — Collect one page of public Bluesky posts by handle or DID with normalized content, author, media, timestamps, and visible engagement.

Explore other platforms

Combine Bluesky data with public data from other supported social platforms.

Bluesky Post API — FAQ

Bluesky Post API is a programmatic interface for retrieving one public Bluesky post from a known post URL. It returns normalized text, author identity, media, timestamps, hashtags, mentions, and visible engagement counts.

Submit one non-empty reference whose parsed hostname is bsky.app or a bsky.app subdomain. The backend accepts absolute references with any scheme and protocol-relative references; the request accepts the url field only.

The post schema includes identity and source fields, text, publication and collection times, author details, media, hashtags, mentions, and available like, comment, repost, and view counts. Nullable fields remain empty when the public source does not expose a usable value.

No. The result represents the selected post and can expose a visible comments_count, but the post schema does not return separate reply records or a reply tree.

No. The request resolves one url and does not accept results_limit; read the returned item through the standard task result envelope.

Each successful Bluesky Post API task costs a fixed 0.19 SocQ credits. The charge does not depend on a requested or returned result count.