reddit: Search posts
reddit_searchSearch posts. Reddit post search, site-wide or restricted to one subreddit with subreddit, in Reddit's own ranking with scores and comment counts. Reddit returns seven results a page; pass pagination.cursor for the next. raw.posts names each result's subreddit. Body text comes from Reddit's feed of the same query and is null for a result that feed does not carry. raw.via names the surface that answered; on atom, scores and comment counts are null. Costs 1 credit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "reddit_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | relevance | |
| limit | No | Results per page, 1-100. Default 25. | |
| query | Yes | Search terms. Reddit's own syntax works, e.g. `flair:"news"`. | |
| cursor | No | `pagination.cursor` from a previous response | |
| subreddit | No | Restrict to one subreddit | |
| timeframe | No | Window for the search. Default "all". | |
| cache_max_age | No |