get_story_albums()

Client.get_story_albums()

Get all story albums for a user or channel.

Usable by Users Bots

Parameters:

chat_id (int | str) – Unique identifier or username of the target peer. Use "me" or "self" for your own profile.

Returns:

List of StoryAlbum – All albums belonging to the peer. Returns an empty list if no albums exist.

Example

albums = await app.get_story_albums("me")
for album in albums:
    print(album.album_id, album.title)