reddit_search
Search Reddit posts and comments by query, optionally limiting results to a subreddit and filtering by sort order or timeframe.
Instructions
reddit: Search. GET /v1/reddit/search. Search Reddit for posts or comments. Anonymous search looks in one subreddit: pass subreddit, or a single-word query, which is also used as the subreddit. sort and timeframe apply where the archive supports them. An empty page costs 0 credits. Search does not return upvote ratios. Use /v1/reddit/post for a post's upvote_ratio. Costs 1 credit when it succeeds. Costs 0 credits when posts is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
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 | Sort by. Comment search supports relevance, new, and top; comment_count is for post search only. | |
| trim | No | Set true for a trimmed response. | |
| after | No | Used to paginate to next page | |
| query | Yes | Search query | |
| filter | No | Search posts or comments | |
| subreddit | No | Limit the search to this subreddit. | |
| timeframe | No | Post search timeframe |