All endpoints
Bluesky Post Comments

Bluesky Post Comments API

Get the replies to a Bluesky post. Returns every reply Bluesky serves for the thread, nested up to 10 levels deep, as a flat list; each reply is a full post with in_reply_to_id pointing at its parent.

Price: $0.003 per request
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/bluesky/post/comments

Parameters

url
Bluesky post URL, e.g. https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l (max 500 characters). Provide either url or post_id.
post_id
The post's AT URI as returned in post_id, e.g. at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l (max 200 characters). Provide either url or post_id.
get_sentiment
Set to true to add AI emotion analysis (Plutchik's Wheel) to each result. Adds +$0.001 per request to the cost. Returns emotion scores, dominant emotion, intensity, and polarity.

Response fields

comments
Array of replies, thread order (a reply is followed by the replies to it)
title
Post title (format: @handle on Bluesky)
url
Direct link to the post
date
Publication date and time (UTC, YYYY-MM-DD HH:MM:SS)
author
Author's Bluesky handle
author_name
Author's display name
author_id
Author's DID (permanent account ID)
author_verified
Whether the author is verified
source
"Bluesky"
domain
"bsky.app"
snippet
Post text
likes
Number of likes
replies
Number of replies
reposts
Number of reposts
quotes
Number of quote posts
bookmarks
Number of bookmarks
lang
Post language code (e.g. en), empty when not set
is_reply
Whether the post is a reply
in_reply_to_id
post_id of the post replied to (empty when not a reply)
is_quote
Whether the post quotes another post
quoted_post
The quoted post (post_id, url, date, author, author_name, author_verified, snippet, likes, reposts), or null
hashtags
Hashtags used in the post
mentions
Handles mentioned in the post
links
URLs linked in the post text
link_preview
Link card for posts sharing a URL (url, title, description, image_url), or null
media_type
text, image, video, or carousel
image_url
Full-size image URL for image posts, the thumbnail for video posts, empty for text-only
video_url
Video playlist URL (HLS) for video posts, empty otherwise
carousel_media
Images of a multi-image post (image_url, thumbnail_url, alt, width, height); empty otherwise
post_id
The post's AT URI (pass it as post_id to the post endpoints)
sentiment
Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)
post_id
The post's AT URI
total
The post's total reply count
count
Number of replies returned

Example Request

curl "https://apidirect.io/v1/bluesky/post/comments?url=https%3A%2F%2Fbsky.app%2Fprofile%2Fbsky.app%2Fpost%2F3l6oveex3ii2l"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "comments": [
    {
      "title": "@bsky.app on Bluesky",
      "url": "https://bsky.app/profile/bsky.app/post/3l6ovfftinx2m",
      "date": "2024-10-17 07:07:26",
      "author": "bsky.app",
      "author_name": "Bluesky",
      "author_id": "did:plc:z72i7hdynmk6r22z27h6tvur",
      "author_verified": false,
      "source": "Bluesky",
      "domain": "bsky.app",
      "snippet": "• Anyone can create and subscribe to feeds. There are 50k+ feeds here, like posts from mutuals, news, or cat photos!\n\nbsky.app/feeds\n\n• The Discover f…",
      "likes": 3254,
      "replies": 60,
      "reposts": 284,
      "quotes": 41,
      "bookmarks": 7,
      "lang": "en",
      "is_reply": true,
      "in_reply_to_id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l",
      "is_quote": false,
      "quoted_post": null,
      "hashtags": [],
      "mentions": [],
      "links": [
        "https://bsky.app/feeds"
      ],
      "link_preview": null,
      "media_type": "text",
      "image_url": "",
      "video_url": "",
      "carousel_media": [],
      "post_id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6ovfftinx2m"
    }
  ],
  "post_id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l",
  "total": 8582,
  "count": 740
}

Frequently asked questions

How do I tell direct replies from nested ones?

A direct reply has in_reply_to_id equal to the requested post's post_id; a nested reply points at another comment in the list.

Why is count lower than total?

Bluesky serves a bounded slice of very large threads (a few hundred replies, nested at most 10 levels deep) and offers no way to page further. total is the post's full reply count; count is what the thread returned.

How does pricing work?

You only pay for successful requests. The Bluesky Post Comments API costs $0.003 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the Bluesky Post Comments API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key