messages.search

Search for messages.

func (c *Client) MessagesSearch(ctx context.Context, request *MessagesSearchRequest) (MessagesMessagesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.MessagesSearch(ctx, &tg.MessagesSearchRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // MessagesMessagesClass
	return nil
})

Parameters

Name	Type	Required	Description
Peer	InputPeerClass	yes	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.
Q	string	yes	Text search request
FromID	InputPeerClass	—	Only return messages sent by the specified user ID
SavedPeerID	InputPeerClass	—	Search within the saved message dialog » with this ID.
SavedReaction	[]ReactionClass	—	You may search for saved messages tagged » with one or more reactions using this flag.
TopMsgID	int	—	Thread ID
Filter	MessagesFilterClass	yes	Filter to return only specified message types
MinDate	int	yes	If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned
MaxDate	int	yes	If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned
OffsetID	int	yes	Only return messages starting from the specified message ID
AddOffset	int	yes	Additional offset
Limit	int	yes	Number of results to return, can be 0 to only return the message counter.
MaxID	int	yes	Maximum message ID to return
MinID	int	yes	Minimum message ID to return
Hash	int64	yes	Hash

Returns

MessagesMessagesClass

Possible errors

Code	Type	Description
400	CHANNEL_INVALID	The provided channel is invalid.
400	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
403	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.

References

• Official documentation
• Generated Go reference
• TL definition: messages.search#29ee847a