app.bsky.unspecced.search_posts_skeleton¶

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

Bases: ParamsModelBase

Parameters model for app.bsky.unspecced.searchPostsSkeleton.

field author: str | str | None = None¶

field cursor: str | None = None¶

field domain: str | None = None¶

field lang: str | None = None¶

field limit: int | None = None¶

Limit.

Constraints:

ge = 1
le = 100

field mentions: str | str | 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'] | Literal['latest'] | str | None = 'latest'¶

field tag: List[str] | None = None¶

field until: str | None = None¶

field url: str | None = None¶

field viewer: str | None = None¶

class atproto_client.models.app.bsky.unspecced.search_posts_skeleton.ParamsDict¶

Bases: TypedDict

author: typing_extensions.NotRequired[str | None]¶: Filter to posts by the given account. Handles are resolved to DID before query-time.

cursor: typing_extensions.NotRequired[str | None]¶: Optional pagination mechanism; may not necessarily allow scrolling through entire result set.

domain: typing_extensions.NotRequired[str | None]¶: Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

lang: typing_extensions.NotRequired[str | None]¶: Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

limit: typing_extensions.NotRequired[int | None]¶: Limit.

mentions: typing_extensions.NotRequired[str | None]¶: Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

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

since: typing_extensions.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: typing_extensions.NotRequired[Literal['top'] | Literal['latest'] | str | None]¶: Specifies the ranking order of results.

tag: typing_extensions.NotRequired[List[str] | None]¶: 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.

until: typing_extensions.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: typing_extensions.NotRequired[str | None]¶: Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

viewer: typing_extensions.NotRequired[str | None]¶

me’ queries.

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

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.