--- title: messages.searchGlobal description: Global message search --- ## Method: messages.searchGlobal [Back to methods index](index.md) Global message search ### Parameters: | Name | Type | Required | Description | |----------|---------------|----------|-------------| |q|[CLICK ME string](../types/string.md) | Yes|The query| |offset\_date|[CLICK ME int](../types/int.md) | Yes|0 or the date offset| |offset\_peer|[Username, chat ID, Update, Message or InputPeer](../types/InputPeer.md) | Optional|0 or the peer offset| |offset\_id|[CLICK ME int](../types/int.md) | Yes|0 or the message ID offset| |limit|[CLICK ME int](../types/int.md) | Yes|The number of results to return| ### Return type: [messages\_Messages](../types/messages_Messages.md) ### Can bots use this method: **NO** ### Errors this method can return: | Error | Description | |----------|---------------| |SEARCH_QUERY_EMPTY|The search query is empty| ### MadelineProto Example: ``` if (!file_exists('madeline.php')) { copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php'); } include 'madeline.php'; // !!! This API id/API hash combination will not work !!! // !!! You must get your own @ my.telegram.org !!! $api_id = 0; $api_hash = ''; $MadelineProto = new \danog\MadelineProto\API('session.madeline', ['app_info' => ['api_id' => $api_id, 'api_hash' => $api_hash]]); $MadelineProto->start(); $messages_Messages = $MadelineProto->messages->searchGlobal(['q' => 'string', 'offset_date' => int, 'offset_peer' => InputPeer, 'offset_id' => int, 'limit' => int, ]); ``` ### [PWRTelegram HTTP API](https://pwrtelegram.xyz) example (NOT FOR MadelineProto): ### As a user: POST/GET to `https://api.pwrtelegram.xyz/userTOKEN/messages.searchGlobal` Parameters: q - Json encoded string offset_date - Json encoded int offset_peer - Json encoded InputPeer offset_id - Json encoded int limit - Json encoded int Or, if you're into Lua: ``` messages_Messages = messages.searchGlobal({q='string', offset_date=int, offset_peer=InputPeer, offset_id=int, limit=int, }) ```