app.bsky.unspecced.searchPostsSkeleton

Backend Posts search, returns only skeleton

class atproto_client.models.app.bsky.unspecced.search_posts_skeleton.Params

Bases: ParamsModelBase

Parameters model for app.bsky.unspecced.searchPostsSkeleton.

field author: AtIdentifier | None = None
field cursor: str | None = None
field domain: str | None = None
field lang: Language | None = None
field limit: int | None = None

Limit.

Constraints:

  • ge = 1

  • le = 100

field mentions: AtIdentifier | None = None
field q: str [Required]

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

field since: str | None = None
field sort: Literal['top', 'latest'] | str | None = 'latest'

Specifies the ranking order of results.

field tag: List[str] | None = None
field until: str | None = None
field url: Uri | None = None
field viewer: Did | None = None
class atproto_client.models.app.bsky.unspecced.search_posts_skeleton.ParamsDict

Bases: TypedDict

q: str

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

author: NotRequired[AtIdentifier | None]

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

cursor: NotRequired[str | None]

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

domain: NotRequired[str | None]

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

lang: NotRequired[Language | None]

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

limit: NotRequired[int | None]

Limit.

mentions: NotRequired[AtIdentifier | None]

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

since: NotRequired[str | None]

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: NotRequired[Literal['top', 'latest'] | str | None]

Specifies the ranking order of results.

tag: NotRequired[List[Annotated[str, FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=640)])]] | None]
until: NotRequired[str | None]

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: NotRequired[Uri | None]

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

viewer: NotRequired[Did | None]

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

class atproto_client.models.app.bsky.unspecced.search_posts_skeleton.Response

Bases: ResponseModelBase

Output data model for app.bsky.unspecced.searchPostsSkeleton.

field cursor: str | None = None

Cursor.

field hits_total: int | None = None
field posts: List[models.AppBskyUnspeccedDefs.SkeletonSearchPost] [Required]

Posts.