Home › Methods › Stories › GetStoryViewsList
Layer 220

StoriesGetStoryViewsList

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

method Users
stories.getStoryViewsList#7ed23c57 flags:# just_contacts:flags.0?true reactions_first:flags.2?true forwards_first:flags.3?true peer:InputPeer q:flags.1?string id:int offset:string limit:int = stories.StoryViewsList;

Parameters

Name Type Description
Flags # Flags, see TL conditional fields
JustContacts flags.0?true Whether to only fetch view reaction/views made by our contacts
ReactionsFirst flags.2?true Whether to return story View 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 story View s with an associated reaction first in the list). Ignored if forwards_first is set.
ForwardsFirst flags.3?true If set, returns forwards and reposts first, then reactions, then other views; otherwise returns interactions sorted just by interaction date.
Peer InputPeer Peer where the story was posted
Q flags.1?string Search for specific peers
Id int Story ID
Offset string Offset for pagination, obtained from stories. story Views List. next_offset
Limit int Maximum number of results to return, see pagination

Returns

stories.StoryViewsList

Possible Errors

Code Type Description
400 PEER_ID_INVALID The provided peer id is invalid.
400 STORY_ID_INVALID The specified story ID is invalid.

Gogram Example

// StoriesGetStoryViewsList - using Params struct
result, err := client.StoriesGetStoryViewsList(&tg.StoriesGetStoryViewsListParams{
    Peer: &tg.InputPeerUser{UserID: int64(123456789)},
    Id: 0,
    Offset: "...",
    Limit: 0,

    // Optional fields:
    // JustContacts: true,
    // ReactionsFirst: true,
    // ForwardsFirst: true,
    // Q: "...",
})
if err != nil {
    // handle error
}
// result is *tg.StoriesStoryViewsList