Lexicon Garden

app.bsky.feed.searchPosts

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.

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

author

string · at-identifier

Filter to posts by the given account. Handles are resolved to DID before query-time.

cursor

string

Optional pagination mechanism; may not necessarily allow scrolling through entire result set.

domain

string

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

lang

string · language

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

limit

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

mentions

string · at-identifier

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

q

requiredstring

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

since

string

Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD).

sort

string

Specifies the ranking order of results.

  • default: "latest"
  • knownValues: top | latest

tag

array

Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix. Multiple tags can be specified, with 'AND' matching.

itemsstring
  • maxLength: 640
  • maxGraphemes: 64

until

string

Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD).

url

string · uri

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

Output

application/json

cursor

string

hitsTotal

integer

Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits.

posts

requiredarray
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.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

  • app.bsky.feed.searchPostsV2

    query

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

  • 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.

  • so.sprk.feed.searchPosts

    query

    Find posts matching search criteria, returning views of those posts.