Struct SearchBuilder 

pub struct SearchBuilder { /* private fields */ }

Fluent builder for messages.search (in-chat message search).

Created by Client::search. All setters are chainable; call fetch to execute.

Implementations

impl SearchBuilder

pub fn min_date(self, ts: i32) -> Self

Only return messages on or after this Unix timestamp.

pub fn max_date(self, ts: i32) -> Self

Only return messages on or before this Unix timestamp.

pub fn filter(self, f: MessagesFilter) -> Self

Apply a MessagesFilter (e.g. photos only, video only, etc.).

pub fn limit(self, n: i32) -> Self

Maximum number of messages to return (default 100).

pub fn offset_id(self, id: i32) -> Self

Start from this message ID (for pagination).

pub fn add_offset(self, off: i32) -> Self

Additional offset for fine-grained pagination.

pub fn max_id(self, id: i32) -> Self

Only return messages with an ID ≤ max_id.

pub fn min_id(self, id: i32) -> Self

Only return messages with an ID ≥ min_id.

pub fn sent_by_self(self) -> Self

Restrict to messages sent by this peer (resolved against the cache). Only return messages sent by the logged-in user.

pub fn from_peer(self, peer: InputPeer) -> Self

Only return messages sent by a specific peer.

pub fn top_msg_id(self, id: i32) -> Self

Restrict search to a specific forum topic.

pub async fn fetch( self, client: &Client, ) -> Result<Vec<IncomingMessage>, InvocationError>

Execute the search and return matching messages.