Link Search Menu Expand Document

Method: stories.searchPosts

Back to methods index

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.

Parameters:

NameTypeDescriptionRequired
hashtagstringHashtag (without the #)Optional
areaMediaAreaA mediaAreaGeoPoint or a mediaAreaVenue.
Note mediaAreaGeoPoint areas may be searched only if they have an associated address.
Optional
peerUsername, chat ID, Update, Message or InputPeerIf set, returns only stories posted by this peer.Optional
offsetstringOffset for pagination: initially an empty string, then the next_offset from the previously returned stories.foundStories.Optional
limitintMaximum number of results to return, see paginationOptional

Return type: stories.FoundStories

Can userbots use this method: YES

Can bots use this method: NO

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$stories_FoundStories = $MadelineProto->stories->searchPosts(hashtag: 'string', area: $MediaArea, peer: $InputPeer, offset: 'string', limit: $int, );