channels.searchPosts

channels.searchPosts

No description provided by the pinned schema.

Signature

channels.searchPosts#f2c4f24d flags:# hashtag:flags.0?string query:flags.1?string offset_rate:int offset_peer:InputPeer offset_id:int limit:int allow_paid_stars:flags.2?long = messages.Messages;

Result type

messages.Messages

Parameters

Name	Type	Flag	Default	Description
flags	#	flag word	—	No description provided by the pinned schema.
hashtag	flags.0?string	flags.0	—	No description provided by the pinned schema.
query	flags.1?string	flags.1	—	No description provided by the pinned schema.
offset_rate	int	—	—	No description provided by the pinned schema.
offset_peer	InputPeer	—	—	No description provided by the pinned schema.
offset_id	int	—	—	No description provided by the pinned schema.
limit	int	—	—	No description provided by the pinned schema.
allow_paid_stars	flags.2?long	flags.2	—	No description provided by the pinned schema.

Flags

Parameter	Bit	Meaning
hashtag	0	Controlled by flags; present when this bit is set.
query	1	Controlled by flags; present when this bit is set.
allow_paid_stars	2	Controlled by flags; present when this bit is set.

Python binding

from miniproto.raw.functions import ChannelsSearchPosts

Public access: miniproto.raw.functions.ChannelsSearchPosts.

Safe usage shape

from miniproto.raw.functions import ChannelsSearchPosts

# Naming the raw request class is local only; it performs no I/O or network request.
request_type = ChannelsSearchPosts

Result family

messages.Messages

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	OFFSET_PEER_ID_INVALID	The provided offset peer 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	PREMIUM_ACCOUNT_REQUIRED	A premium account is required to execute this action.
420	FROZEN_METHOD_INVALID	The current account is frozen, and thus cannot execute the specified action.

Accepted types

InputPeer Known selected constructors: inputPeerChannel, inputPeerChannelFromMessage, inputPeerChat, inputPeerEmpty, inputPeerSelf, inputPeerUser, inputPeerUserFromMessage

Returned types

messages.Messages Known selected constructors: messages.channelMessages, messages.messages, messages.messagesNotModified, messages.messagesSlice

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, 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.search, 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.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.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

• user only

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

• 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