messages.getSearchResultsCalendar

Returns information about the next messages of the specified type in the chat split by days.

Returns the results in reverse chronological order.
Can return partial results for the last returned day.

messages.searchResultsCalendar#147ee23c flags:# inexact:flags.0?true count:int min_date:int min_msg_id:int offset_id_offset:flags.1?int periods:Vector<SearchResultsCalendarPeriod> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.SearchResultsCalendar;
---functions---
messages.getSearchResultsCalendar#49f0bde9 peer:InputPeer filter:MessagesFilter offset_id:int offset_date:int = messages.SearchResultsCalendar;

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
offset_date int Offsets for pagination, for more info click here

Result

messages.SearchResultsCalendar

Possible errors

Code Type Description
400 FILTER_NOT_SUPPORTED The specified filter cannot be used in this context.
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.