search_stories()

async Client.search_stories()

Search public stories by hashtag, location area, or chat.

Usable by Users Bots
Parameters:
  • hashtag (str, optional) – The hashtag to search for.

  • chat_id (int | str, optional) – Target chat to limit the search to.

  • offset (str, optional) – Pagination offset. Defaults to empty string.

  • limit (int, optional) – Number of stories to return. Defaults to 100.

  • area (MediaArea, optional) – Media area / location to search stories for.

Returns:

FoundStories – On success, found stories object is returned.

Example

stories = await app.search_stories(hashtag="travel")