Search for messages and peers globally
Method schema is available as of layer 100. Switch »
| 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 »). |
| groups_only | flags.2?true | |
| users_only | flags.3?true | |
| 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 |
| 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. |
Telegram allows applying detailed message filters while looking for messages in chats.
Telegram allows placing chats into folders, based on their type, mute status, or other custom criteria, thanks to folder blacklists and whitelists.
Incomplete list of messages and auxiliary data.
How to fetch results from large lists of objects.