All endpoints
Bluesky User Posts

Bluesky User Posts API

Get a user's feed by handle: their posts, replies, and reposts in feed order (the pinned post first, then newest first), each flagged with is_reply, is_repost, and is_pinned. Returns post text, engagement metrics, media, link cards, and quoted posts.

Price: $0.003 per page
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/bluesky/user/posts

Parameters

username
Bluesky handle, e.g. bsky.app, with or without leading @, or the account's DID (max 100 characters). Provide either username or url.
url
Bluesky profile URL, e.g. https://bsky.app/profile/bsky.app (max 500 characters). Provide either username or url.
pages
Number of pages to fetch, 1-20 (default: 1). Each page returns up to 50 posts; you are billed per page returned.
get_sentiment
Set to true to add AI emotion analysis (Plutchik's Wheel) to each result. Adds +$0.001 per page to the cost. Returns emotion scores, dominant emotion, intensity, and polarity.

Response fields

posts
Array of the user's feed items: the pinned post first (if any), then newest first
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)
is_repost
Whether this item is a repost by the user (the post fields describe the original post)
reposted_by
Handle of the user who reposted it (empty when not a repost)
is_pinned
Whether the post is pinned to the user's profile
sentiment
Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)
username
The requested handle or DID
pages
Number of pages returned
count
Number of results returned

Example Request

curl "https://apidirect.io/v1/bluesky/user/posts?username=bsky.app&pages=1"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "posts": [
    {
      "title": "@bsky.app on Bluesky",
      "url": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l",
      "date": "2024-10-17 07:06:51",
      "author": "bsky.app",
      "author_name": "Bluesky",
      "author_id": "did:plc:z72i7hdynmk6r22z27h6tvur",
      "author_verified": false,
      "source": "Bluesky",
      "domain": "bsky.app",
      "snippet": "👋  Bluesky is an open social network that gives creators independence from platforms, developers the freedom to build, and users a choice in their exp…",
      "likes": 63685,
      "replies": 8582,
      "reposts": 9530,
      "quotes": 708,
      "bookmarks": 249,
      "lang": "en",
      "is_reply": false,
      "in_reply_to_id": "",
      "is_quote": false,
      "quoted_post": null,
      "hashtags": [],
      "mentions": [],
      "links": [],
      "link_preview": null,
      "media_type": "text",
      "image_url": "",
      "video_url": "",
      "carousel_media": [],
      "post_id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l",
      "is_repost": false,
      "reposted_by": "",
      "is_pinned": true
    }
  ],
  "username": "bsky.app",
  "pages": 1,
  "count": 50
}

Frequently asked questions

Does the feed include replies and reposts?

Yes, the full feed is returned. Filter on is_reply to drop replies and on is_repost to drop reposts. For a repost, the post fields describe the original post and reposted_by names the user.

How many posts can I fetch in one call?

Up to 20 pages of 50 posts (1,000 items), newest first. You are billed only for the pages that come back.

How does pricing work?

You only pay for successful requests. The Bluesky User Posts API costs $0.003 per page. 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 User Posts API

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

Get API Key