Lexicon Garden

app.bsky.feed.searchPostsV2

Find posts matching a search query or filters, returning search hits for matching post records.

Repository @bsky-lexicons.bsky.social did:plc:4v4y5r3lwsbtmsxhile2ljac namespace authority
Details · query
Kindquery
Authorityfeed.bsky.app
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

allTime

boolean

Search the full index instead of the recent-post window.

authors

array

Include posts by any of these authors. Handles are resolved to DIDs before searching.

itemsstring · at-identifier

cursor

string

Optional pagination cursor.

domains

array

Include posts that link to any of these domains.

itemsstring

embeddedAtUris

array

Include posts that embed any of these AT URIs.

itemsstring · at-uri

excludeAuthors

array

Exclude posts by any of these authors. Handles are resolved to DIDs before searching.

itemsstring · at-identifier

excludeDomains

array

Exclude posts that link to any of these domains.

itemsstring

excludeEmbeddedAtUris

array

Exclude posts that embed any of these AT URIs.

itemsstring · at-uri

excludeHashtags

array

Exclude posts tagged with any of these hashtags. Do not include the hash (#) prefix.

itemsstring
  • maxLength: 640
  • maxGraphemes: 64

excludeLanguages

array

Exclude posts whose language matches any of these language codes.

itemsstring · language

excludeMentions

array

Exclude posts that mention any of these accounts. Handles are resolved to DIDs before searching.

itemsstring · at-identifier

excludeReplies

boolean

Exclude replies from results. Mutually exclusive with repliesOnly.

excludeUrls

array

Exclude posts that link to any of these URLs.

itemsstring · uri

following

boolean

Include only posts from accounts followed by the viewer.

hasMedia

boolean

Include only posts with media.

hasVideo

boolean

Include only posts with video.

hashtags

array

Include posts tagged with any of these hashtags. Do not include the hash (#) prefix.

itemsstring
  • maxLength: 640
  • maxGraphemes: 64

languages

array

Include posts whose language matches any of these language codes.

itemsstring · language

limit

integer

Maximum number of results to return.

  • minimum: 1
  • maximum: 100
  • default: 25

mentions

array

Include posts that mention any of these accounts. Handles are resolved to DIDs before searching.

itemsstring · at-identifier

query

string

Search query string. A query or at least one filter is required.

queryLanguage

string

Language analyzer hint for the query text. If unset, the server auto-detects when possible.

  • knownValues: ja | zh | ko | th | ar

repliesOnly

boolean

Include only replies. Mutually exclusive with excludeReplies.

replyParentUri

string · at-uri

Include only direct replies to this parent post URI.

since

string

Include posts indexed at or after this timestamp. Can be a datetime, or just an ISO date (YYYY-MM-DD).

sort

string

Ranking order for results. 'recent' sorts by recency; 'top' uses search ranking.

  • knownValues: recent | top

threadRootUri

string · at-uri

Include only posts in the thread rooted at this post URI.

until

string

Include posts indexed before this timestamp. Defaults to the current time. Can be a datetime, or just an ISO date (YYYY-MM-DD).

urls

array

Include posts that link to any of these URLs.

itemsstring · uri

Output

application/json

cursor

string

Cursor for the next page of results.

detectedQueryLanguages

array

Query languages detected for CJK, Thai, or Arabic text. Empty or omitted for other scripts.

itemsstring
  • knownValues: ja | zh | ko | th | ar

hitsTotal

integer

Estimated total number of matching hits. May be rounded or truncated.

posts

requiredarray

Hydrated views of matching posts.

itemsref
Reference

Errors

BadQueryString

No description in schema.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • town.delve.feed.searchPostsV2

    query not from the namespace authority

    Find posts matching a search query or filters, returning search hits for matching post records.

  • app.bsky.feed.searchPosts

    query

    Find posts matching search criteria, returning views of those posts. Note that this API endpoint may require authentication (eg, not public) for some service providers and implementations.

  • town.delve.feed.searchPosts

    query not from the namespace authority

    Find posts matching search criteria, returning views of those posts. Note that this API endpoint may require authentication (eg, not public) for some service providers and implementations.

  • town.delve.unspecced.searchPostsSkeleton

    query not from the namespace authority

    Backend Posts search, returns only skeleton

  • social.coves.feed.searchPosts

    query

    Full-text search over visible posts, across every community or restricted to one. Results honour the same admission, deletion and viewer-block rules as social.coves.feed.getDiscover and social.coves.feed.getCommunity.