Link Search Menu Expand Document

Method: messages.search

Back to methods index

Search for messages.

Parameters:

NameTypeDescriptionRequired
peerUsername, chat ID, Update, Message or InputPeerUser 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.Optional
qstringText search requestOptional
from_idUsername, chat ID, Update, Message or InputPeerOnly return messages sent by the specified user IDOptional
saved_peer_idUsername, chat ID, Update, Message or InputPeerSearch within the saved message dialog » with this ID.Optional
saved_reactionArray of ReactionOptional
top_msg_idintThread IDOptional
filterMessagesFilterFilter to return only specified message typesOptional
min_dateintIf a positive value was transferred, only messages with a sending date bigger than the transferred one will be returnedOptional
max_dateintIf a positive value was transferred, only messages with a sending date smaller than the transferred one will be returnedOptional
offset_idintOnly return messages starting from the specified message IDOptional
add_offsetintAdditional offsetOptional
limitintNumber of results to returnOptional
max_idintMaximum message ID to returnOptional
min_idintMinimum message ID to returnOptional
hashArray of long|stringHashOptional

Return type: messages.Messages

Can userbots use this method: YES

Can bots use this method: NO

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$messages_Messages = $MadelineProto->messages->search(peer: $InputPeer, q: 'string', from_id: $InputPeer, saved_peer_id: $InputPeer, saved_reaction: [$Reaction, $Reaction], top_msg_id: $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\|string, $long\|string], );