Globally search for posts from public channels » (including those we aren't a member of) containing either a specific hashtag, or a full text query.
Exactly one of query and hashtag must be set.
Method schema is available as of layer 211. Switch »
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| hashtag | flags.0?string | The hashtag to search, without the # character. |
| query | flags.1?string | The full text query: each user has a limited amount of free full text search slots, after which payment is required, see here » for more info on the full flow. |
| offset_rate | int | Initially 0, then set to the next_rate parameter of messages.messagesSlice, or if that is absent, the date of the last returned message. |
| offset_peer | InputPeer | Offsets for pagination, for more info click here |
| offset_id | int | Offsets for pagination, for more info click here |
| limit | int | Maximum number of results to return, see pagination |
| allow_paid_stars | flags.2?long | For full text post searches (query), allows payment of the specified amount of Stars for the search, see here » for more info on the full flow. |
| Code | Type | Description |
|---|---|---|
| 420 | FROZEN_METHOD_INVALID | The current account is frozen, and thus cannot execute the specified action. |
Telegram allows applying detailed message filters while looking for messages in chats.
Incomplete list of messages and auxiliary data.
How to fetch results from large lists of objects.
How to handle channels, supergroups, gigagroups, basic groups, and what's the difference between them.
How to register a user's phone to start using the API.