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")