Bluesky

Search Bluesky Posts

Search Bluesky posts by keyword. Returns post text, author, publication date, engagement metrics (likes, replies, reposts, quotes, bookmarks), media, link cards, and quoted posts. Supports sorting, a date window, and fetching multiple pages in a single API call. Set get_sentiment=true to add AI emotion analysis (+$0.001/page).

Price: $0.003 per page. Free tier: 50 requests/month.

get/v1/bluesky/posts

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/bluesky/posts
  • Auth: API key in header X-API-Key

Query parameters

querystring required

Search keyword (max 500 characters). Bluesky search syntax works: "exact phrase", -exclude, from:handle, lang:en, #tag

pagesinteger

Number of pages to fetch and merge into one response (1-20, billed per page returned). Each page returns up to 50 results. Fetching stops early when there are no more results.

sort_by'most_recent' | 'relevance'

Sort order: most_recent or relevance (default: most_recent)

start_datestring date

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

end_datestring date

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

get_sentimentboolean

Set to true to add AI emotion analysis to each result. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any item that cannot be scored returns sentiment: null.

Response

Successful response

pagesnumber nullable
countnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.