Search Messages
Search for messages in a guild
GET /guilds/{guild.id}/messages/search
Search for messages in a DM
GET /channels/{channel.id}/messages/search
Returns search results object or a 202 Accepted with response code 110000 (Index not yet available. Try again later) if the guild/channel is not indexed
GET parameters:
Field | Type | Description |
---|---|---|
content | string | term to search for |
offset? | integer | offset into search results |
channel_id? | snowflake | channel to restrict search to |
author_id? | snowflake | author to restrict search to |
mentions? | snowflake | restrict search to mentions of given user |
has? | string | "link", "embed", or "file" |
max_id? | snowflake | maximum id of the search results. used for before: |
min_id? | snowflake | minimum id of the search results. used for after: |
sort_by? | string | relevance or timestamp |
sort_order? | string | desc or asc |
include_nsfw? | boolean | include NSFW results |
Search Results Object
Field | Type | Description |
---|---|---|
analytics_id(?) | string | unknown |
messages | array of message objects | messages matching search query |
total_results | integer |