Search Reddit posts
search_redditSearch Reddit posts by title and body text using quoted terms, Boolean operators, subreddit filters, sorting, and pagination to locate relevant discussions and threads.
Instructions
Search Reddit posts by title and body text. Reddit's API cannot search comment text.
Unquoted multi-word queries are matched loosely and ranked by popularity, so
dremio reflections tips returns unrelated posts. Use one to three specific terms,
drop generic words (tips, best, help), and use the syntax Reddit supports:
"dremio" quote a rare or exact term or phrase
dremio AND iceberg require both terms
subreddit:dataengineering only that community (or pass subreddit="a+b")
-subreddit:jobboardsearch exclude a community (job-bot spam is common for product names)
flair:Discussion title:benchmark selftext:kubernetes author:name site:github.com
Each result starts with [id]: read one thread with get_post, or the full bodies of
many results with get_posts. To find advice inside comments, open the most
discussed threads (sort="comments") with get_post. Output is capped near 50,000
characters; the last line gives the cursor for the next page.
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": "search_reddit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | relevance (default), top, new, hot, or comments (most discussed). | relevance |
| time | No | Time window. | all |
| after | No | Cursor from a previous 'next: after=...' line, for the next page. | |
| limit | No | Results per page, 1 to 100. | |
| query | Yes | Search terms and operators (see the tool description). | |
| subreddit | No | Limit to one subreddit ("dataengineering") or several ("a+b"). Empty = all of Reddit. | |
| body_chars | No | Characters of each post body to show, 0 to 4000. | |
| include_nsfw | No | Show posts, comments and communities Reddit marks NSFW (18+). Off by default; hidden items are counted in the output. A server setting can keep them hidden even when true. |