bluesky

Search

Returns Bluesky posts matching a keyword, up to 100 per page, each with its text, author, like/comment/share counts, and when it was written.

Use it to find posts by keyword across all of Bluesky; use user/posts when you already know the account.

10 credits per call.

get/v1/bluesky/search

Request

Base URL: https://api.insightsocial.app
URL: https://api.insightsocial.app/v1/bluesky/search
Auth: API key in header x-api-key

Query parameters

querystring required

Example:espresso

Search terms matched against post text.

sort'latest' | 'top'

latest (newest first, the default) or top (Bluesky's own top ranking, which favours popular posts over recent ones).

sincestring

Only posts written at or after this time. ISO 8601 date (2026-09-01) or datetime with a timezone (2026-09-01T00:00:00Z); any other shape is rejected with a free 400.

untilstring

Only posts written before this time. Same format as since. Set it to the oldest published_at of your last call to fetch the next older batch; the boundary is compared to the second, so a post from that same second can repeat, and deduplicating on post.id removes it.

langstring

Only posts tagged with this language, as a code such as en, ja or ko.

authorstring

Only posts by this account: a handle such as espn.com or a did such as did:plc:.... An account that does not exist returns an empty list.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required

platformstring required

endpointstring required

schema_version'2' required

unavailablestring[] required

credits_usedinteger required

credits_remaininginteger required

request_idstring required

cachedboolean required

idempotent_replayboolean required

charge_reasonstring required

free_callboolean required

Changes

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