messages.searchGlobal

Search for messages and peers globally

messages.messages#8c718e87 messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.messagesSlice#c8edce1e flags:# inexact:flags.1?true count:int next_rate:flags.0?int messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.channelMessages#99262e37 flags:# inexact:flags.1?true pts:int count:int messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.messagesNotModified#74535f21 count:int = messages.Messages;
---functions---
messages.searchGlobal#4bc6589a flags:# broadcasts_only:flags.1?true groups_only:flags.2?true users_only:flags.3?true folder_id:flags.0?int q:string filter:MessagesFilter min_date:int max_date:int offset_rate:int offset_peer:InputPeer offset_id:int limit:int = messages.Messages;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
broadcasts_only flags.1?true If set, only returns results from channels (used in the global channel search tab ยป).
folder_id flags.0?int Peer folder ID, for more info click here
q string Query
filter MessagesFilter Global search filter
min_date int If a positive value was specified, the method will return only messages with date bigger than min_date
max_date int If a positive value was transferred, the method will return only messages with date smaller than max_date
offset_rate int Initially 0, then set to the next_rate parameter of messages.messagesSlice
offset_peer InputPeer Offsets for pagination, for more info click here
offset_id int Offsets for pagination, for more info click here
limit int Offsets for pagination, for more info click here

Result

messages.Messages

Possible errors

Code Type Description
400 FOLDER_ID_INVALID Invalid folder ID.
400 INPUT_FILTER_INVALID The specified filter is invalid.
400 SEARCH_QUERY_EMPTY The search query is empty.

Related pages

Search

Telegram allows applying detailed message filters while looking for messages in chats.

Folders

Telegram allows placing chats into folders, based on their type, mute status, or other custom criteria, thanks to folder blacklists and whitelists.

messages.messagesSlice

Incomplete list of messages and auxiliary data.

Pagination in the API

How to fetch results from large lists of objects.