get_story_views()

Client.get_story_views()

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

Usable by Users Bots
Parameters:

  • chat_id (``int`` | ``str``) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str).

  • story_id (``int``) – Pass a story identifier to get the story views.

  • offset (``str``, *optional*) – Offset of the results to be returned.

  • limit (``int``, *optional*) – Maximum number of views to return.

  • contacts_only (``bool``, *optional*) – Only Get views made by your contacts, Defaults to False.

  • reactions_first (``bool``, *optional*) – If True, return reactions first, Defaults to False.

  • forwards_first (``bool``, *optional*) – If True, return forwards first, Defaults to False.

  • query (``str``, *optional*) – Search for specific users.

Returns:

``Generator`` (A generator yielding StoryView objects.)

Example

# Get views
async for view in app.get_story_views(chat_id, story_id):
    print(view)