telegram api method · layer 229 · #29ee847a
messages.search
Search for messages.
definition
messages.search#29ee847a flags:# peer:InputPeer q:string from_id:flags.0?InputPeer saved_peer_id:flags.2?InputPeer saved_reaction:flags.3?Vector<Reaction> top_msg_id:flags.1?int filter:MessagesFilter min_date:int max_date:int offset_id:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
peer | InputPeer | User or chat, histories with which are searched, or (inputPeerEmpty) constructor to search in all private chats and normal groups (not channels) ». Use messages.searchGlobal to search globally in all chats, groups, supergroups and channels. |
q | string | Text search request |
from_id | InputPeer | Only return messages sent by the specified user ID |
saved_peer_id | InputPeer | Search within the saved message dialog » with this ID. |
saved_reaction | Vector<Reaction> | You may search for saved messages tagged » with one or more reactions using this flag. |
top_msg_id | int | Thread ID |
filter | MessagesFilter | Filter to return only specified message types |
min_date | int | If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned |
max_date | int | If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned |
offset_id | int | Only return messages starting from the specified message ID |
add_offset | int | Additional offset |
limit | int | Number of results to return, can be 0 to only return the message counter. |
max_id | int | Maximum message ID to return |
min_id | int | Minimum message ID to return |
hash | long | Hash |
returns
errors (16)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. |
| 400 | CHANNEL_PRIVATE | You haven't joined this channel/supergroup. |
| 400 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 400 | CHAT_ID_INVALID | The provided chat id is invalid. |
| 400 | FROM_PEER_INVALID | The specified from_id is invalid. |
| 400 | INPUT_FILTER_INVALID | The specified filter is invalid. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. |
| 400 | MSG_ID_INVALID | Invalid message ID provided. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | PEER_ID_NOT_SUPPORTED | The provided peer ID is not supported. |
| 400 | SEARCH_QUERY_EMPTY | The search query is empty. |
| 400 | TAKEOUT_INVALID | The specified takeout ID is invalid. |
| 400 | USER_ID_INVALID | The provided user ID is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
history
present in layers 2–229 · constructor id changed 9×
| id | layers |
|---|---|
| #07e9f2ab | 2–23 |
| #d4569248 | 46–67 |
| #f288a275 | 68–70 |
| #039e9ea0 | 71–75 |
| #8614ef68 | 76–118 |
| #4e17810b | 119 |
| #0c352eec | 120–132 |
| #a0fda762 | 133–169 |
| #a7b4e929 | 170 |
| #29ee847a | 171–229 |