Bluesky Posts API

Endpoint

GET /v1/bluesky/posts

Parameters

query *

Search keyword (max 500 characters). Bluesky search operators are supported, including quoted phrases, -exclude, from and lang.

pages

Number of pages to fetch, 1-20 (default: 1). Each page returns up to 50 posts; you are billed per page returned.

sort_by

Sort order: most_recent or relevance (default: most_recent)

start_date

Only posts from this date onward (format: YYYY-MM-DD)

end_date

Only posts up to this date (format: YYYY-MM-DD)

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 matching posts

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)

pages

Number of pages returned

count

Number of results returned

Example Request

curl "https://apidirect.io/v1/bluesky/posts?query=anthropic&pages=1&sort_by=most_recent"   -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/bluesky/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "anthropic", "pages": 1, "sort_by": "most_recent"}
)
print(response.json())

Example Response

{
  "posts": [
    {
      "title": "@papoo7.bsky.social on Bluesky",
      "url": "https://bsky.app/profile/papoo7.bsky.social/post/3mvnldg3l2u24",
      "date": "2026-09-16 16:40:21",
      "author": "papoo7.bsky.social",
      "author_name": "",
      "author_id": "did:plc:57j4dnzyvdjl2bici4u3oero",
      "author_verified": false,
      "source": "Bluesky",
      "domain": "bsky.app",
      "snippet": "Anthropic is asking for brakes after helping build the car\nhttps://papoo.work/doc/f150d1ed17a55c33\n#claudenews #anthropic #claude #llm #agents",
      "likes": 0,
      "replies": 0,
      "reposts": 0,
      "quotes": 0,
      "bookmarks": 0,
      "lang": "en",
      "is_reply": false,
      "in_reply_to_id": "",
      "is_quote": false,
      "quoted_post": null,
      "hashtags": [
        "claudenews",
        "anthropic",
        "claude",
        "llm",
        "agents"
      ],
      "mentions": [],
      "links": [
        "https://papoo.work/doc/f150d1ed17a55c33"
      ],
      "link_preview": {
        "url": "https://papoo.work/doc/f150d1ed17a55c33",
        "title": "Anthropic is asking for brakes after helping build the car",
        "description": "",
        "image_url": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:57j4dnzyvdjl2bici4u3oero/bafkreib5cpnglprvtxzloallnma2vwnzypd2t2nr…"
      },
      "media_type": "text",
      "image_url": "",
      "video_url": "",
      "carousel_media": [],
      "post_id": "at://did:plc:57j4dnzyvdjl2bici4u3oero/app.bsky.feed.post/3mvnldg3l2u24"
    }
  ],
  "pages": 1,
  "count": 50
}

Frequently asked questions

How recent are the results?

Posts are searched live on Bluesky, so results run from the last few seconds back through the network's full history. Use sort_by=most_recent for a newest-first feed, or start_date and end_date to pin a window.

Can I use search operators?

Yes. The query is passed to Bluesky's own search, so "exact phrase", -exclude, from:handle, lang:en, domain:example.com and #tag all work.

How is a multi-page request billed?

Each page holds up to 50 posts and you are billed per page returned. If the search runs out of results before the requested page count, you only pay for the pages that came back.

How does pricing work?

You only pay for successful requests. The Bluesky 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.