Bluesky Post Details API

What is the Bluesky Post Details API?

Pass a Bluesky post URL and get the public thread (app.bsky.feed.getPostThread) — not a duplicate of a user-posts row. Beyond the list card you get: nested replies[] with per-reply author/text/engagement (depth, default 1, max 6), parentUri/rootUri/isReply so a reply is never mistaken for a root post, facet-derived links[] (full URIs — Bluesky truncates long URLs inside text), mentions[] with did, and hashtags[], post-level labels[] + langs[], and a rich author{handle,displayName,did,avatar,createdAt,labels[],verification{},verified} matching bluesky/profile (including !no-unauthenticated compliance labels). Embeds use the same normalized type namespace as user-posts (external | images | video | quote). Flat 1 credit. This is the only Captapi surface that returns Bluesky reply content.

What you get

• Nested replies[] from getPostThread (depth 0–6)
• Facet links[] / mentions[{did}] / hashtags[] — not regex over truncated text
• Rich author: verification{}, labels[], createdAt
• parentUri / rootUri / isReply + post labels[] + langs[]

Platform limits

Honest ceilings from the upstream platform surface — not Captapi bugs. Unexpected truncation here is usually the platform, not us.

• depth defaults to 1; large threads can return many reply rows in one credit.
• Bluesky has no view/play metric — engagement is likes/reposts/replies/quotes only.

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/bluesky/post-details?url=https%3A%2F%2Fbsky.app%2Fprofile%2Fdanabra.mov%2Fpost%2F3mqjnjafz2s2k" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "platform": "bluesky",
    "uri": "at://did:plc:fpruhuo22xkm5o7ttr2ktxdo/app.bsky.feed.post/3mqjnjafz2s2k",
    "url": "https://bsky.app/profile/danabra.mov/post/3mqjnjafz2s2k",
    "cid": "bafyreib46qdetrzwrcu35fqynwkiw6tscptkvlxcujk5f745jmzqox5jz4",
    "text": "i want to do a little ✨ ama about atproto ✨ in this thread. no question is too simple\n\nif you’ve been curious about atproto but don’t know much (anything?) about it, ask any question and i’ll try to explain it in my own words.\n\n(+ would love to hear from friends who aren’t very active on bsky)",
    "publishedAt": "2026-07-13T12:02:47.424Z",
    "indexedAt": "2026-07-13T12:02:47.867Z",
    "author": {
      "handle": "danabra.mov",
      "displayName": "dan",
      "did": "did:plc:fpruhuo22xkm5o7ttr2ktxdo",
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:fpruhuo22xkm5o7ttr2ktxdo/bafkreif43mhqajnbnl62u3ezf37g6x22nd762im54thxbil4ga46eugcga"
    },
    "engagement": {
      "likes": 340,
      "reposts": 82,
      "replies": 104,
      "quotes": 9
    },
    "embed": null
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/bluesky/post-details and parse the JSON response.

Use cases

Frequently asked questions

More Bluesky APIs