search_posts
Search Reddit posts by keywords, subreddit, author, and date range; sort results and choose live or archive sources for targeted research.
Instructions
Search posts by keywords, subreddit, author and date range.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Default: relevance on live, new on archive. relevance/hot/top/comments need live; new works on both; old only on the archive. | |
| time | No | Time window | |
| after | No | Archive only: posted after this date (2024-01-31, epoch, or '30d') | |
| limit | No | ||
| query | No | Keywords. Live supports reddit search syntax. | |
| author | No | Restrict to one author | |
| before | No | Archive only: posted before this date | |
| cursor | No | next_cursor from a previous call | |
| source | No | Data source. 'auto' tries live reddit.com (if a session cookie is configured) and falls back to the Arctic Shift archive; 'live' or 'archive' forces one. | auto |
| subreddit | No | Restrict to one subreddit |