messages.search
messages.search
Section titled “messages.search”No description provided by the pinned schema.
Signature
Section titled “Signature”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;Result type
Section titled “Result type”messages.Messages
Parameters
Section titled “Parameters”| Name | Type | Flag | Default | Description |
|---|---|---|---|---|
| flags | # | flag word | — | No description provided by the pinned schema. |
| peer | InputPeer | — | — | No description provided by the pinned schema. |
| q | string | — | — | No description provided by the pinned schema. |
| from_id | flags.0?InputPeer | flags.0 | — | No description provided by the pinned schema. |
| saved_peer_id | flags.2?InputPeer | flags.2 | — | No description provided by the pinned schema. |
| saved_reaction | flags.3?Vector | flags.3 | — | No description provided by the pinned schema. |
| top_msg_id | flags.1?int | flags.1 | — | No description provided by the pinned schema. |
| filter | MessagesFilter | — | — | No description provided by the pinned schema. |
| min_date | int | — | — | No description provided by the pinned schema. |
| max_date | int | — | — | No description provided by the pinned schema. |
| offset_id | int | — | — | No description provided by the pinned schema. |
| add_offset | int | — | — | No description provided by the pinned schema. |
| limit | int | — | — | No description provided by the pinned schema. |
| max_id | int | — | — | No description provided by the pinned schema. |
| min_id | int | — | — | No description provided by the pinned schema. |
| hash | long | — | — | No description provided by the pinned schema. |
| Parameter | Bit | Meaning |
|---|---|---|
| from_id | 0 | Controlled by flags; present when this bit is set. |
| saved_peer_id | 2 | Controlled by flags; present when this bit is set. |
| saved_reaction | 3 | Controlled by flags; present when this bit is set. |
| top_msg_id | 1 | Controlled by flags; present when this bit is set. |
Python binding
Section titled “Python binding”from miniproto.raw.functions import MessagesSearchPublic access: miniproto.raw.functions.MessagesSearch.
Safe usage shape
Section titled “Safe usage shape”from miniproto.raw.functions import MessagesSearch
# Naming the raw request class is local only; it performs no I/O or network request.request_type = MessagesSearchResult family
Section titled “Result family”RPC errors
Section titled “RPC errors”| 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. |
Accepted types
Section titled “Accepted types”InputPeer, MessagesFilter, Reaction
Known selected constructors: inputPeerChannel, inputPeerChannelFromMessage, inputPeerChat, inputPeerEmpty, inputPeerSelf, inputPeerUser, inputPeerUserFromMessage, inputMessagesFilterChatPhotos, inputMessagesFilterContacts, inputMessagesFilterDocument, inputMessagesFilterEmpty, inputMessagesFilterGeo, inputMessagesFilterGif, inputMessagesFilterMusic, inputMessagesFilterMyMentions, inputMessagesFilterPhoneCalls, inputMessagesFilterPhotoVideo, inputMessagesFilterPhotos, inputMessagesFilterPinned, inputMessagesFilterPoll, inputMessagesFilterRoundVideo, inputMessagesFilterRoundVoice, inputMessagesFilterUrl, inputMessagesFilterVideo, inputMessagesFilterVoice, reactionCustomEmoji, reactionEmoji, reactionEmpty, reactionPaid
Returned types
Section titled “Returned types”messages.Messages
Known selected constructors: messages.channelMessages, messages.messages, messages.messagesNotModified, messages.messagesSlice
Related methods
Section titled “Related methods”account.disablePeerConnectedBot, account.getPaidMessagesRevenue, account.reportPeer, account.reportProfilePhoto, account.saveAutoSaveSettings, account.toggleConnectedBotPaused, account.toggleNoPaidMessagesException, bots.setCustomVerification, channels.deleteParticipantHistory, channels.editBanned, channels.getMessages, channels.getParticipant, channels.getSendAs, channels.reportSpam, channels.searchPosts, chatlists.editExportedInvite, chatlists.exportChatlistInvite, chatlists.joinChatlistInvite, chatlists.joinChatlistUpdates, chatlists.leaveChatlist, communities.create, communities.getParticipantJoinedChats, communities.toggleParticipantBanned, communities.togglePeerLink, communities.togglePeerLinkRequestApproval, contacts.block, contacts.resetTopPeerRating, contacts.setBlocked, contacts.unblock, ephemeral.deleteMessage, ephemeral.editMessage, ephemeral.getCallbackAnswer, ephemeral.reportMessage, ephemeral.sendMessage, help.dismissSuggestion, help.hidePromoData, messages.acceptUrlAuth, messages.addPollAnswer, messages.appendTodoList, messages.checkHistoryImportPeer, messages.createForumTopic, messages.deleteExportedChatInvite, messages.deleteFactCheck, messages.deleteHistory, messages.deleteParticipantReaction, messages.deleteParticipantReactions, messages.deletePollAnswer, messages.deleteRevokedExportedChatInvites, messages.deleteSavedHistory, messages.deleteScheduledMessages, messages.deleteTopicHistory, messages.editChatAbout, messages.editChatCreator, messages.editChatDefaultBannedRights, messages.editChatParticipantRank, messages.editExportedChatInvite, messages.editFactCheck, messages.editForumTopic, messages.editMessage, messages.exportChatInvite, messages.forwardMessages, messages.getAdminsWithInvites, messages.getBotCallbackAnswer, messages.getChatInviteImporters, messages.getDialogUnreadMarks, messages.getDialogs, messages.getDiscussionMessage, messages.getExportedChatInvite, messages.getExportedChatInvites, messages.getExtendedMedia, messages.getFactCheck, messages.getForumTopics, messages.getForumTopicsByID, messages.getFutureChatCreatorAfterLeave, messages.getGameHighScores, messages.getHistory, messages.getInlineBotResults, messages.getMessageEditData, messages.getMessageReactionsList, messages.getMessageReadParticipants, messages.getMessages, messages.getMessagesReactions, messages.getMessagesViews, messages.getOnlines, messages.getOutboxReadDate, messages.getPeerSettings, messages.getPersonalChannelHistory, messages.getPollResults, messages.getPollVotes, messages.getQuickReplyMessages, messages.getRecentLocations, messages.getReplies, messages.getRichMessage, messages.getSavedDialogs, messages.getSavedDialogsByID, messages.getSavedHistory, messages.getSavedReactionTags, messages.getScheduledHistory, messages.getScheduledMessages, messages.getSearchCounters, messages.getSearchResultsCalendar, messages.getSearchResultsPositions, messages.getSponsoredMessages, messages.getUnreadMentions, messages.getUnreadPollVotes, messages.getUnreadReactions, messages.hideAllChatJoinRequests, messages.hideChatJoinRequest, messages.hidePeerSettingsBar, messages.initHistoryImport, messages.markDialogUnread, messages.prolongWebView, messages.rateTranscribedAudio, messages.readDiscussion, messages.readHistory, messages.readMentions, messages.readPollVotes, messages.readReactions, messages.readSavedHistory, messages.reorderPinnedForumTopics, messages.report, messages.reportMessagesDelivery, messages.reportReaction, messages.reportReadMetrics, messages.reportSpam, messages.requestAppWebView, messages.requestMainWebView, messages.requestUrlAuth, messages.requestWebView, messages.saveDefaultSendAs, messages.saveDraft, messages.searchGlobal, messages.searchSentMedia, messages.sendBotRequestedPeer, messages.sendInlineBotResult, messages.sendMedia, messages.sendMessage, messages.sendMultiMedia, messages.sendPaidReaction, messages.sendQuickReplyMessages, messages.sendReaction, messages.sendScheduledMessages, messages.sendScreenshotNotification, messages.sendVote, messages.setChatAvailableReactions, messages.setChatTheme, messages.setChatWallPaper, messages.setDefaultReaction, messages.setGameScore, messages.setHistoryTTL, messages.setTyping, messages.startBot, messages.startHistoryImport, messages.summarizeText, messages.toggleNoForwards, messages.togglePaidReactionPrivacy, messages.togglePeerTranslations, messages.toggleSuggestedPostApproval, messages.toggleTodoCompleted, messages.transcribeAudio, messages.translateRichMessage, messages.translateText, messages.unpinAllMessages, messages.updatePinnedForumTopic, messages.updatePinnedMessage, messages.updateSavedReactionTag, messages.uploadImportedMedia, messages.uploadMedia, payments.changeStarsSubscription, payments.connectStarRefBot, payments.createStarGiftCollection, payments.deleteStarGiftCollection, payments.editConnectedStarRefBot, payments.fulfillStarsSubscription, payments.getConnectedStarRefBot, payments.getConnectedStarRefBots, payments.getGiveawayInfo, payments.getPaymentReceipt, payments.getPremiumGiftCodeOptions, payments.getSavedStarGifts, payments.getStarGiftCollections, payments.getStarsRevenueAdsAccountUrl, payments.getStarsRevenueStats, payments.getStarsRevenueWithdrawalUrl, payments.getStarsStatus, payments.getStarsSubscriptions, payments.getStarsTransactions, payments.getStarsTransactionsByID, payments.getSuggestedStarRefBots, payments.launchPrepaidGiveaway, payments.reorderStarGiftCollections, payments.sendStarGiftOffer, payments.toggleChatStarGiftNotifications, payments.toggleStarGiftsPinnedToTop, payments.transferStarGift, payments.updateStarGiftCollection, phone.createGroupCall, phone.deleteGroupCallParticipantMessages, phone.editGroupCallParticipant, phone.getGroupCallJoinAs, phone.getGroupCallStreamRtmpUrl, phone.getGroupParticipants, phone.joinGroupCall, phone.saveDefaultGroupCallJoinAs, phone.saveDefaultSendAs, phone.sendGroupCallMessage, premium.applyBoost, premium.getBoostsList, premium.getBoostsStatus, premium.getUserBoosts, stats.getPollStats, stats.getStoryPublicForwards, stats.getStoryStats, stories.canSendStory, stories.createAlbum, stories.deleteAlbum, stories.deleteStories, stories.editStory, stories.exportStoryLink, stories.getAlbumStories, stories.getAlbums, stories.getPeerMaxIDs, stories.getPeerStories, stories.getPinnedStories, stories.getStoriesArchive, stories.getStoriesByID, stories.getStoriesViews, stories.getStoryReactionsList, stories.getStoryViewsList, stories.incrementStoryViews, stories.readStories, stories.reorderAlbums, stories.report, stories.searchPosts, stories.sendReaction, stories.sendStory, stories.startLive, stories.togglePeerStoriesHidden, stories.togglePinned, stories.togglePinnedToTop, stories.updateAlbum
Availability evidence
Section titled “Availability evidence”- user only
Provenance
Section titled “Provenance”- layer: 228
- structural source:
tdlib - canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
- prose merge precedence: TDLib → Telegram Desktop → Core JSON
- source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.
Source-diff notes
Section titled “Source-diff notes”- tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
- tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery
miniprotoFast paths where they count. Explicit boundaries everywhere else.