telegram api method · layer 229 · #973478b6

contacts.getTopPeers

usable by users

Get most used peers

definition

contacts.getTopPeers#973478b6 flags:# correspondents:flags.0?true bots_pm:flags.1?true bots_inline:flags.2?true phone_calls:flags.3?true forward_users:flags.4?true forward_chats:flags.5?true groups:flags.10?true channels:flags.15?true bots_app:flags.16?true bots_guestchat:flags.17?true offset:int limit:int hash:long = contacts.TopPeers;

parameters

nametypedescription
flags#Flags, see TL conditional fields
correspondentsflags.0?trueUsers we've chatted most frequently with
bots_pmflags.1?trueMost used bots
bots_inlineflags.2?trueMost used inline bots
phone_callsflags.3?trueMost frequently called users
forward_usersflags.4?trueUsers to which the users often forwards messages to
forward_chatsflags.5?trueChats to which the users often forwards messages to
groupsflags.10?trueOften-opened groups and supergroups
channelsflags.15?trueMost frequently visited channels
bots_appflags.16?trueMost frequently used Main Mini Bot Apps.
bots_guestchatflags.17?true
offsetintOffset for pagination
limitintMaximum number of results to return, see pagination
hashlongHash used for caching, for more info click here

returns

contacts.TopPeers

errors (3)

codeerrordescription
400BUSINESS_CONNECTION_NOT_ALLOWEDThis 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.
400TYPES_EMPTYNo top peer type was provided.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

history

present in layers 62–229 · constructor id changed 1×

idlayers
#d4982db562–132
#973478b6133–229