Searches for messages matching a query.
| |
|---|
| Surface | search |
| Rate limit | Tier 2 (20/min) |
| Argument | Required | Type | |
|---|
count | no | integer | Pass the number of results you want per “page”. Maximum of 100. |
highlight | no | boolean | Pass a value of true to enable query highlight markers (see below). |
page | no | integer | |
query | yes | string | Search query. |
sort | no | string | Return matches sorted by either score or timestamp. |
sort_dir | no | string | Change sort direction to ascending (asc) or descending (desc). |
Works with every official Slack SDK — call it exactly as you would against Slack.
| |
|---|
| Source spec | Slack Web API OpenAPI v1.7.0 (apis.guru OAS3 conversion of slackapi/slack-api-specs, upstream archived 2024-03) |
| Retrieved / verified | 2026-06-04 · patches applied: 0 |
| In frozen spec | yes — fields below are copied from the published spec |
| Conformance | exercised by unmodified official SDKs on every release |
| See also | Slack’s search.messages reference |