get_stories()¶

Client.get_stories()¶

Get one or more stories from a chat by using stories identifiers.

Usable by Users Bots

Parameters:

chat_id (int | str, optional) – Unique identifier (int) or username (str) of the target user. For your personal story 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_ids (int | Iterable of int | str, optional) – Pass a single story identifier or an iterable of story ids (as integers) or link to get the content of the story themselves.

Returns:

Story | List of Story – In case story_ids was not a list, a single story is returned, otherwise a list of stories is returned.

Example

# Get stories by id
stories = await app.get_stories(chat_id, [1, 2, 3])

for story in stories:
    print(story)