Retrieves a list of messages containing a specific search term.
Note: Message search is limited to up to 100 public and private group channels joined by a specified user.
The following table lists the parameters that this action supports.
Specifies the channel url to restrict the search scope to a specific group channel.
Restricts the search scope to only retrieve messages from one or more channels where the specified users are members. The search targets up to 100 private and public group channels joined by the user. Urlencoding the value is recommended (for example,
Searches for messages that contain content that matches the specified search term. When
Specifies the custom channel type to restrict the search scope. This custom_type should be specified in conjunction with
Specifies the number of messages to return per page. Acceptable values are 1 to 99, inclusive. (Default: 20)
Determines whether to search for messages that contain an exact match for the search term. If set to false, it returns partial matches that contain the search term. (Default: false)
Determines whether to apply advanced search functionalities to the
Determines whether to search for messages containing synonyms of the search term. (Default: false)
Specifies the primary field to sort the results. Acceptable values are the following:
Determines whether to include a score indicating how relevant each result is to the search term in the search results. The
Restricts the search scope to the messages sent after the specified value in Unix milliseconds format. This includes messages sent exactly on the timestamp.
Restricts the search scope to the messages sent before the specified value in Unix milliseconds format. This includes messages sent exactly on the timestamp.
Marks the starting point of the search results to retrieve in the result set. The
Marks the end point of the search results to retrieve in the result set. The
Determines whether to sort the results in reverse order. If set to true, either messages with the lowest score appear first (when
Specifies a page token that indicates the starting index of a chunk of results to retrieve. If not specified, the index is set as 0.
array of strings
Specifies an array of user IDs to restrict the search scope to messages that are sent by the specified IDs. Up to five
Determines whether to show detailed information about the target channel in the response. (Default: false)
If successful, this action returns a list of messages that contain the search term in the response body like the following.
array of objects
An array of messages that match the specified parameters.
The starting index of the current results.
The ending index of the current results.
Indicates whether there is a previous page of results.
Indicates whether there is a next page of results.
The value that can be used in the
In the case of an error, an error object is returned. A detailed list of error codes is available here.