telegram api method · layer 229 · #7ed23c57
stories.getStoryViewsList
Obtain the list of users that have viewed a specific story we posted
definition
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 |
just_contacts | true | Whether to only fetch view reaction/views made by our contacts |
reactions_first | true | Whether 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. |
forwards_first | 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 | string | Search for specific peers |
id | int | Story ID |
offset | string | Offset for pagination, obtained from stories.storyViewsList.next_offset |
limit | int | Maximum number of results to return, see pagination |
returns
errors (4)
| code | error | description |
|---|---|---|
| 400 | BUSINESS_CONNECTION_NOT_ALLOWED | This 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. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | STORY_ID_INVALID | The specified story ID is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
history
present in layers 160–229 · constructor id changed 2×
| id | layers |
|---|---|
| #4b3b5e97 | 160 |
| #f95f61a4 | 161–163 |
| #7ed23c57 | 164–229 |