Link Search Menu Expand Document

Method: stories.getStoryViewsList

Back to methods index

Obtain the list of users that have viewed a specific story we posted

Parameters:

NameTypeDescriptionRequired
just_contactsBoolWhether to only fetch view reaction/views made by our contactsOptional
reactions_firstBoolWhether to return storyView info about users that reacted to the story (i.e. if set, the server will first sort results by view date as usual, and then also additionally sort the list by putting storyViews with an associated reaction first in the list). Ignored if forwards_first is set.Optional
forwards_firstBoolIf set, returns forwards and reposts first, then reactions, then other views; otherwise returns interactions sorted just by interaction date.Optional
peerUsername, chat ID, Update, Message or InputPeerPeer where the story was postedOptional
qstringSearch for specific peersOptional
idintStory IDOptional
offsetstringOffset for pagination, obtained from stories.storyViewsList.next_offsetOptional
limitintMaximum number of results to return, see paginationOptional

Return type: stories.StoryViewsList

Can userbots use this method: YES

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();

$stories_StoryViewsList = $MadelineProto->stories->getStoryViewsList(just_contacts: $Bool, reactions_first: $Bool, forwards_first: $Bool, peer: $InputPeer, q: 'string', id: $int, offset: 'string', limit: $int, );