reddit_subreddit_search
Search a specific subreddit for posts, comments, or media matching a query. Sort by relevance, hot, top, or new and page through results with a cursor.
Instructions
reddit: Subreddit Search. GET /v1/reddit/subreddit/search. Search within a subreddit for posts, comments, or media matching a query Costs 1 credit when it succeeds. 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": {
"subreddit": "<subreddit>"
},
"name": "reddit_subreddit_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new | |
| query | No | Search query to find matching content | |
| cursor | No | Cursor to get more results. Get 'cursor' from previous response. | |
| subreddit | Yes | Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL) | |
| timeframe | No | Timeframe to filter results |