Skip to content

searchChatMessages

Sahri Riza Umami edited this page Mar 14, 2017 · 4 revisions

Searches for messages with given words in the chat.

searchChatMessages(chat_id, query, from_message_id, limit, filter)

Returns result in reverse chronological order, i. e. in order of decreasimg message_id.
Doesn't work in secret chats.

Option Description
chat_id Chat identifier to search in.
query Query to search for
from_message_id Identifier of the message from which we need a history, you can use 0 to get results from beginning.
limit Maximum number of messages to be returned, can't be greater than 100.
filter Filter for content of searched messages. The filters are Empty, Animation, Audio, Document, Photo, Video, Voice, PhotoAndVideo, Url, and ChatPhoto.

Example

  • Return all found messages.

    searchChatMessages(1234567890, 'merbot', 0, 17, 'Empty')
  • Return only animation messages.

    searchChatMessages(1234567890, 'tzuyu', 0, 17, 'Animation')
  • Return only audio messages.

    searchChatMessages(1234567890, 'leessang', 0, 17, 'Audio')
  • Return only document messages.

    searchChatMessages(1234567890, 'dummies', 0, 17, 'Document')
  • Return only photo messages.

    searchChatMessages(1234567890, 't520', 0, 17, 'Photo')
  • Return only video messages.

    searchChatMessages(1234567890, 'turbo', 0, 17, 'Video')
  • Return only voice messages.

    searchChatMessages(1234567890, 'anu', 0, 17, 'Voice')
  • Return only photo and video messages.

    searchChatMessages(1234567890, 'gunung', 0, 17, 'PhotoAndVideo')
  • Return only messages containing url.

    searchChatMessages(1234567890, 'kaskus', 0, 17, 'Url')
  • Return only messages containing chat photos.

    searchChatMessages(1234567890, 'saru', 0, 17, 'Photo')

Test script
Frequently Asked Questions
The Functions

Clone this wiki locally