App Logo
discord.com

Search Discord server messages

Automatically search Discord server messages on discord.com. Search a Discord server's message history, newest first, using Discord's own search, as the signed-in account: it reaches every server that account is in, with no bot to invite. The query accepts Discord's search syntax (plain words, or filters like from:, in:, has:, before:, during:), so scoping to a channel or author is done in the query itself. Returns per hit: messageId, channelId, url, author (id, handle, name), content, timestamp, plus total_results as Discord reports it and complete, which is false when more hits exist beyond the page read. Discord returns search hits with surrounding context messages; only the hits themselves are returned. It searches one server at a time; for direct messages (DMs), list the conversations with discord.com/list_dms and read one with discord.com/read_messages.

Input

query required

What to search for. Discord's own search syntax works here, e.g. 'deploy', 'from:someone deploy', 'in:general has:link'. Always use the English keywords (from:/in:/has:/mentions:) regardless of the signed-in account's Discord display language -- the script translates them internally.

guildId required

Server id to search, e.g. from discord.com/list_servers.

limit optional

How many hits to return, newest first. Discord serves 25 per page and this reads one page, so 25 is the maximum; total_results tells you how many exist.

Default: 25

Output

count required
query required
guildId required
messages required
complete optional

True when every hit Discord reported was returned; false when more exist beyond this page.

total_results optional

Discord's own count of matching messages, which can exceed the number returned.

FAQ

Search a Discord server's message history, newest first, using Discord's own search, as the signed-in account: it reaches every server that account is in, with no bot to invite. The query accepts Discord's search syntax (plain words, or filters like from:, in:, has:, before:, during:), so scoping to a channel or author is done in the query itself. Returns per hit: messageId, channelId, url, author (id, handle, name), content, timestamp, plus total_results as Discord reports it and complete, which is false when more hits exist beyond the page read. Discord returns search hits with surrounding context messages; only the hits themselves are returned. It searches one server at a time; for direct messages (DMs), list the conversations with discord.com/list_dms and read one with discord.com/read_messages.
Ask an AI agent connected to Reduck to run reduck/discord.com/search_messages, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/discord.com/search_messages
You do not need one. "Search Discord server messages" drives the real discord.com pages in a browser, so it works whether or not discord.com offers an API for this.
Required: guildId, query. Optional: limit.
It returns count, query, guildId, complete, messages, total_results.
Yes. It acts as you on discord.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the discord.com cookies saved by the Reduck extension.
It only reads. It looks things up on discord.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/discord.com/search_messages, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/discord.com/search_messages
It is part of Reduck's official curated catalogue.

Related scripts

discord.com

Read Discord messages

Reads the most recent messages of a Discord channel or direct message (author, timestamp, text), newest first, scrolling up to load more until the requested count. Requires being logged in. A DM or group DM is read the same way: pass its url from discord.com/list_dms. It also reads a thread or a forum post, since both are channels in their own right: pass the post's url (from discord.com/list_forum_posts) and you get its replies plus the opening post, newest first — there is no separate thread-reading script. To list the posts of a forum channel rather than its messages, use discord.com/list_forum_posts instead.

discord.com

Post a Discord message

Posts a text message, optionally with a file attached, in a Discord channel addressed by its URL. Requires being logged in to Discord. Returns `sent` plus the created message's messageId, channelId, timestamp and content as Discord stored it. The message is visible to everyone who can see the channel. Empty messages and messages over 2000 characters are refused with a clear reason. Use dry_run to check a channel and message without posting.

discord.com

Delete Discord message

Deletes a single Discord message by id (e.g. to clean up a message you sent). Requires being logged in as the message's author or having Manage Messages in the channel.

Start building not clicking

Get started for free