stories.searchPosts

Globally search for stories using a hashtag or a location media area, see here » for more info on the full flow.

Either hashtag or area must be set when invoking the method.

stories.foundStories#e2de7737 flags:# count:int stories:Vector<FoundStory> next_offset:flags.0?string chats:Vector<Chat> users:Vector<User> = stories.FoundStories;
---functions---
stories.searchPosts#6cea116a flags:# hashtag:flags.0?string area:flags.1?MediaArea offset:string limit:int = stories.FoundStories;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
hashtag flags.0?string Hashtag (without the #)
area flags.1?MediaArea A mediaAreaGeoPoint or a mediaAreaVenue.
Note mediaAreaGeoPoint areas may be searched only if they have an associated address.
offset string Offset for pagination: initially an empty string, then the next_offset from the previously returned stories.foundStories.
limit int Maximum number of results to return, see pagination

Result

stories.FoundStories

Possible errors

Code Type Description
400 HASHTAG_INVALID The specified hashtag is invalid.

Related pages

mediaAreaGeoPoint

Represents a geolocation tag attached to a story.

mediaAreaVenue

Represents a location tag attached to a story, with additional venue information.

Pagination in the API

How to fetch results from large lists of objects.

stories.foundStories

Stories found using global story search ».

Stories

Telegram users and channels can easily post and view stories through the API.