MadelineProtoDocs/docs/API_docs/methods/messages.search.md
2024-05-01 14:53:46 +02:00

3.5 KiB

title description grand_parent parent image redirect_from
messages.search Search for messages. Telegram RPC API Methods https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png /API_docs/methods/messages_search.html

Method: messages.search

Back to methods index

Search for messages.

Parameters:

Name Type Description Required
peer Username, chat ID, Update, Message or 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. Optional
q string Text search request Optional
from_id Username, chat ID, Update, Message or InputPeer Only return messages sent by the specified user ID Optional
saved_peer_id Username, chat ID, Update, Message or InputPeer Search within the saved message dialog » with this ID. Optional
saved_reaction Array of Reaction Optional
top_msg_id int Thread ID Optional
filter MessagesFilter Filter to return only specified message types Optional
min_date int If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned Optional
max_date int If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned Optional
offset_id int Only return messages starting from the specified message ID Optional
add_offset int Additional offset Optional
limit int Number of results to return Optional
max_id int Maximum message ID to return Optional
min_id int Minimum message ID to return Optional
hash Array of long Hash Optional

Return type: messages.Messages

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, $long], );