telegram api method · layer 229 · #d1810907

stories.searchPosts

usable by users

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

definition

stories.searchPosts#d1810907 flags:# hashtag:flags.0?string area:flags.1?MediaArea peer:flags.2?InputPeer offset:string limit:int = stories.FoundStories;

parameters

nametypedescription
flags#Flags, see TL conditional fields
hashtagflags.0?stringHashtag (without the #)
areaflags.1?MediaAreaA mediaAreaGeoPoint or a mediaAreaVenue. Note mediaAreaGeoPoint areas may be searched only if they have an associated address.
peerflags.2?InputPeerIf set, returns only stories posted by this peer.
offsetstringOffset for pagination: initially an empty string, then the next_offset from the previously returned stories.foundStories.
limitintMaximum number of results to return, see pagination

returns

stories.FoundStories

errors (3)

codeerrordescription
400BUSINESS_CONNECTION_NOT_ALLOWEDThis method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection.
400HASHTAG_INVALIDThe specified hashtag is invalid.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

history

present in layers 182–229 · constructor id changed 1×

idlayers
#6cea116a182–191
#d1810907192–229