messages.getSearchResultsPositions

Returns sparse positions of messages of the specified type in the chat to be used for shared media scroll implementation.

Returns the results in reverse chronological order (i.e., in order of decreasing message_id).

messages.searchResultsPositions#53b22baf count:int positions:Vector<SearchResultsPosition> = messages.SearchResultsPositions;
---functions---
messages.getSearchResultsPositions#9c7f2f10 flags:# peer:InputPeer saved_peer_id:flags.2?InputPeer filter:MessagesFilter offset_id:int limit:int = messages.SearchResultsPositions;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
peer InputPeer Peer where to search
saved_peer_id flags.2?InputPeer Search within the saved message dialog ยป with this ID.
filter MessagesFilter Message filter, inputMessagesFilterEmpty, inputMessagesFilterMyMentions filters are not supported by this method.
offset_id int Offsets for pagination, for more info click here
limit int Maximum number of results to return, see pagination

Result

messages.SearchResultsPositions

Possible errors

Code Type Description
400 PEER_ID_INVALID The provided peer id is invalid.

Related pages

Saved messages

The Saved Messages chat allows users to bookmark messages and media: it's a personal cloud storage for any messages or media you may want to send or forward there.

inputMessagesFilterEmpty

Filter is absent.

inputMessagesFilterMyMentions

Return only messages where the current user was mentioned.

Pagination in the API

How to fetch results from large lists of objects.