Search subreddit posts

What it does

Searches public Reddit posts within a subreddit. Supports relevance, hot, top, new, and comments sorting with optional time windows.

Tool details

Field	Value
Tool name	`reddit_search_subreddit_posts`
Platform	Reddit
REST endpoint	`GET /v1/reddit/subreddits/{subreddit}/search`
Result type	Collection tool

Parameters

Parameter	Type	Required	Description
`subreddit`	`string`	Yes	Subreddit name (with or without `r/` prefix)
`q`	`string`	Yes	Search query
`count`	`integer`	No	Number of posts to fetch (maximum: 100) Default: `25`.
`cursor`	`string`	No	Pagination cursor
`order`	`string`	No	Sort order: relevance (default), hot, top, new, or comments Default: `relevance`. Allowed values: `relevance`, `hot`, `top`, `new`, `comments`.
`time`	`string`	No	Optional time window for search results: hour, day, week, month, year, or all Allowed values: `hour`, `day`, `week`, `month`, `year`, `all`.
`projection_preset`	`string`	No	Defaults to `minimal`. Allowed values: `full`, `minimal`, `identity`, `engagement`, `content`.
`data_fields`	`string[]`	No	Adds top-level keys from `data` on top of the selected `projection_preset`.
`item_fields`	`string[]`	No	Adds keys from `data.orderedItems[]` on top of the selected `projection_preset`.

Example

{
  "name": "reddit_search_subreddit_posts",
  "arguments": {
    "subreddit": "programming",
    "q": "<q>",
    "count": 25,
    "projection_preset": "minimal",
    "data_fields": [
      "orderedItems",
      "nextCursor",
      "cursor",
      "itemCount"
    ],
    "item_fields": [
      "entityId",
      "name",
      "published",
      "content",
      "url"
    ]
  }
}

Available data fields

@context
type
partOf
totalItems
cursor
nextCursor
next
itemCount
orderedItems

Available item fields

type
id
url
entityId
name
content
published
isEdited
isLocked
isOriginal
isPinned
isSponsored
isAdult
isSpoiler
isSearchable
likeCount
voteCount
commentCount
shareCount
attributedTo
icon
image
attachment
tag
quote

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.

MCP

Tools

Chat

Automation

Code

What it does

Tool details

Parameters

Example

Available data fields

Available item fields

Response notes

​What it does

​Tool details

​Parameters

​Example

​Available data fields

​Available item fields

​Response notes

What it does

Tool details

Parameters

Example

Available data fields

Available item fields

Response notes