town.delve.unspecced.searchPostsSkeleton

Backend Posts search, returns only skeleton

Repository @delve.town did:plc:qzqct2rrq4u2gmy5g3mjxske namespace authority
Details · query
Kindquery
Authorityunspecced.delve.town
Indexed

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.

viewer

string · did

DID of the account making the request (not included for public/unauthenticated queries). Used for 'from:me' queries.

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

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.

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

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

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

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

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