Search APIs
Loading…
← API Store
Social

Bluesky

Bluesky

Bluesky post search

GET /bluesky/v1/search/posts
Test this endpoint

Posts matching a query. Filters: sort (top/latest), since/until (ISO date or datetime), author (handle or DID), mentions, lang, domain, url, tag (comma-separated, all must match). total is Bluesky's hit estimate. Pass next_cursor back as cursor; it is null on the last page. Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: nasa
sorttop | latesttop (default) or latest.
sincestringOnly posts after this date/time (e.g. 2026-01-31 or 2026-01-31T00:00:00Z).
untilstringOnly posts before this date/time.
authorstringOnly posts by this handle or DID.
mentionsstringOnly posts mentioning this handle or DID.
langstringLanguage code, e.g. en.
domainstringOnly posts linking to this domain.
urlstringOnly posts linking to this URL.
tagstringHashtags (without #), comma-separated; all must match.
limitintegerItems per page, 1-100 (default 25).
cursorstring`next_cursor` from the previous page.

Every endpoint also takes: raw、fields、fresh、output、records

No sample yet

This endpoint has no published sample. Use “Test this endpoint” to run it in the console playground.