get_all_stories()

async Client.get_all_stories()

Get all active or hidden stories that displayed on the action bar on the homescreen.

Usable by Users Bots
Parameters
next (bool, optional):

If next and state are both set, uses the passed state to paginate to the next results. If neither state nor next are set, fetches the initial page. If state is set and next is not set, check for changes in the active/hidden peerset.

hidden (bool, optional):

If set, fetches the hidden active story list, otherwise fetches the active story list.

state (str, optional):

If next and state are both set, uses the passed state to paginate to the next results. If neither state nor next are set, fetches the initial page. If state is set and next is not set, check for changes in the active/hidden peerset.

Parameters:

  • next (bool, optional) – Pass True to get the next page of stories rather than the first.

  • hidden (bool, optional) – Pass True to get the stories of the chats the user has hidden from the action bar, instead of the ones shown on it.

  • state (str, optional) – The pagination state returned with the previous page. When the peerset has not changed since that state, nothing is yielded.

Returns:

Generator – On success, a generator yielding Story objects is returned.

Example

# Get all active story
async for story in app.get_all_stories():
    print(story)