get_stories()

Client.get_stories()

Get one or more stories by their IDs.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat. For your own stories you can use “me” or “self”.

  • story_ids (int | List of int) – Story ID or list of story IDs to get.

Returns:

StoryItem | List of StoryItem – On success, if a single story ID was passed, the story is returned, otherwise a list of stories is returned.

Example

# Get a single story
story = await app.get_stories(chat_id, 12345)

# Get multiple stories
stories = await app.get_stories(chat_id, [12345, 12346, 12347])