App Logo
web.whatsapp.com

Search WhatsApp messages

Automatically search WhatsApp messages on web.whatsapp.com. Search WhatsApp messages by words, in every chat or inside one chat given by its `chatId` from get_inbox. Returns the matching messages, newest first, each with its id, chat, sender (in groups), time and text, so a hit feeds get_conversation and the message scripts. Results come in pages: ask the next page while `complete` is false. A page can hold fewer results than asked. An empty list means nothing matched. Searching opens no chat and marks nothing as read. The search covers the messages this browser holds; older ones may only be on the phone. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab.

Input

query required

Words to search for in message text.

page optional

Page of results, newest first. Ask the next page while `complete` is false.

Default: 1
count optional

Results per page.

Default: 20
chatId optional

Search inside this chat only, as get_inbox returns it in `chatId`. Omit to search every chat.

Output

complete required

True when no further page exists.

messages required

Matching messages, newest first.

FAQ

Search WhatsApp messages by words, in every chat or inside one chat given by its `chatId` from get_inbox. Returns the matching messages, newest first, each with its id, chat, sender (in groups), time and text, so a hit feeds get_conversation and the message scripts. Results come in pages: ask the next page while `complete` is false. A page can hold fewer results than asked. An empty list means nothing matched. Searching opens no chat and marks nothing as read. The search covers the messages this browser holds; older ones may only be on the phone. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab.
Ask an AI agent connected to Reduck to run reduck/web.whatsapp.com/search_messages, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/web.whatsapp.com/search_messages
You do not need one. "Search WhatsApp messages" drives the real web.whatsapp.com pages in a browser, so it works whether or not web.whatsapp.com offers an API for this.
Required: query. Optional: page, count, chatId.
It returns complete, messages.
Yes. It acts as you on web.whatsapp.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the web.whatsapp.com cookies saved by the Reduck extension.
It only reads. It looks things up on web.whatsapp.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/web.whatsapp.com/search_messages, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/web.whatsapp.com/search_messages
It is part of Reduck's official curated catalogue.

Related scripts

web.whatsapp.com

Get WhatsApp conversation

Read the most recent messages of one WhatsApp chat, oldest first. Give the chat by its `chatId` from get_inbox. Each message gives its id, type, sender (in groups), time, text or caption, whether it was deleted for everyone, the delivery status of your own messages, file details for media, and its reactions with counts. `complete` is true when the start of the chat's history was reached. Reading does not open the chat, so nothing is marked as read and the other person gets no read receipt. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab. If the browser is not linked to WhatsApp, the run stops and says so. An unknown chatId stops the run with an error.

web.whatsapp.com

Send WhatsApp message or attachment

Send a WhatsApp message to a chat, given by its `chatId` from get_inbox, or to a phone number in international format that has no chat yet. The message is a text, an image, a video or a document with an optional caption, or a saved contact's card. Returns the new message's id, which delete_message and react_to_message take, with the time, the delivery status and the account that sent it. The run succeeds only when WhatsApp's server has acknowledged the message, and fails if WhatsApp marks it as failed. With dry_run, the chat is opened and the message prepared, and nothing is sent. Confirm the recipient with the user before sending. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab.

web.whatsapp.com

Get WhatsApp inbox

List the chats of the WhatsApp chat list, in the order the list shows them, most recent first. Pick the same tab as the app: all chats, unread, favorites, groups, or archived. Each chat gives its id, its name, when it was last active, its unread count, whether it is pinned, muted, a favorite or marked unread by hand, and its last message with id, type, sender, time and text. `total` tells how many chats the tab holds, so a result cut by `count` is visible. Reading the list does not open a chat and marks nothing as read. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab, because taking the session would disconnect it. If the browser is not linked to WhatsApp, the run stops and says so.

Start building not clicking

Get started for free