reddit_search_comments
Find Reddit posts whose discussions mention a keyword, even if the title doesn't. Searches comment text and returns the parent posts with title, selftext, score, and comment count.
Instructions
Search Reddit by COMMENT text. Reddit's comment search matches your keyword against comment bodies but returns the PARENT POSTS, not the individual comments, so each result is a post whose discussion mentions your query, carrying that post's title, selftext, score, and comment count. Use it to surface threads where a topic comes up in the replies that plain post-title search would miss. Reddit does not expose which specific comment matched or its text, so this returns posts, not comment bodies. For the actual comment bodies, use reddit_deep_comment_search. Example: q='best mechanical keyboard' sort='top'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query text. Supports Reddit search syntax (e.g. `subreddit:webdev`, `author:spez`, `"exact phrase"`, `title:...`). | |
| t | No | Time window that bounds which posts the search returns, e.g. 'week' = only posts from the past week. Unlike a subreddit listing, search applies this to the 'relevance' and 'top' sorts too. When omitted, Reddit defaults to 'all', so a broad 'relevance' query surfaces old high-upvote posts that only loosely match. Pass 'week' or 'month' to keep results recent and on-topic. | |
| nsfw | No | Set 'true' to include over-18 / NSFW results. Omit or 'false' to exclude them (default). | |
| sort | No | Sort order for search. 'relevance' = best match (default), 'top' = highest score in the `t` window, 'new' = most recent, 'hot' = trending, 'comments' = most-discussed. | |
| after | No | Opaque Reddit pagination cursor from the previous response's `after` field (a fullname like `t3_abc123`). Omit on the first call; pass it to fetch the next page. | |
| limit | No | Max items to return (1 to 100). The API clamps out-of-range values; endpoint default applies if omitted. |