MadelineProtoDocs/old_docs/API_docs_v40/methods/contacts.getTopPeers.md
2020-06-16 17:50:25 +02:00

2.6 KiB

title description image redirect_from
contacts.getTopPeers Get most used peers https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png /API_docs/methods/contacts_getTopPeers.html

Method: contacts.getTopPeers

Back to methods index

Get most used peers

Parameters:

Name Type Description Required
correspondents Bool Users we've chatted most frequently with Optional
bots_pm Bool Most used bots Optional
bots_inline Bool Most used inline bots Optional
phone_calls Bool Most frequently called users Optional
forward_users Bool Users to which the users often forwards messages to Optional
forward_chats Bool Chats to which the users often forwards messages to Optional
groups Bool Often-opened groups and supergroups Optional
channels Bool Most frequently visited channels Optional
offset int Offset for pagination Yes
limit int Maximum number of results to return, see pagination Yes
hash Array of int Hash for pagination, for more info click here Optional

Return type: contacts.TopPeers

Can bots use this method: NO

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$contacts.TopPeers = $MadelineProto->contacts->getTopPeers(['correspondents' => Bool, 'bots_pm' => Bool, 'bots_inline' => Bool, 'phone_calls' => Bool, 'forward_users' => Bool, 'forward_chats' => Bool, 'groups' => Bool, 'channels' => Bool, 'offset' => int, 'limit' => int, 'hash' => [int, int], ]);

Or, if you're into Lua:

contacts.TopPeers = contacts.getTopPeers({correspondents=Bool, bots_pm=Bool, bots_inline=Bool, phone_calls=Bool, forward_users=Bool, forward_chats=Bool, groups=Bool, channels=Bool, offset=int, limit=int, hash={int}, })

Errors

Code Type Description
400 TYPES_EMPTY No top peer type was provided