search_submissions
Find Reddit posts by filtering subreddit, author, date range, score, or keyword search.
Instructions
Search Reddit submissions (posts). Supports filtering by subreddit, author, date range, score, and keyword search.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query - searches across all submission fields | |
| size | No | Number of results to return (default: 25, max: 100) | |
| sort | No | Sort order (default: desc) | |
| after | No | Return results after this date. Accepts epoch timestamp or relative date like '30d', '1y' | |
| score | No | Filter by score. Use >N, <N, or N for exact match | |
| title | No | Search in submission titles only | |
| author | No | Filter by author username | |
| before | No | Return results before this date. Accepts epoch timestamp or relative date like '30d', '1y' | |
| locked | No | Filter locked posts | |
| over_18 | No | Filter NSFW content (true = only NSFW, false = exclude NSFW) | |
| spoiler | No | Filter spoiler posts | |
| is_video | No | Filter video posts | |
| selftext | No | Search in submission body text only | |
| stickied | No | Filter stickied posts | |
| sort_type | No | Field to sort by (default: created_utc) | |
| subreddit | No | Filter by subreddit name (without r/ prefix) | |
| num_comments | No | Filter by number of comments. Use >N, <N, or N for exact match |