Method: 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.
Parameters:
Name | Type | Description | Required |
---|---|---|---|
hashtag | string | Hashtag (without the # ) | Optional |
area | MediaArea | A mediaAreaGeoPoint or a mediaAreaVenue. Note mediaAreaGeoPoint areas may be searched only if they have an associated address . | Optional |
peer | Username, chat ID, Update, Message or InputPeer | If set, returns only stories posted by this peer. | Optional |
offset | string | Offset for pagination: initially an empty string, then the next_offset from the previously returned stories.foundStories. | Optional |
limit | int | Maximum number of results to return, see pagination | Optional |
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, );