Search Reddit subreddit
Search posts within a subreddit.
Operation
/v1/reddit/subreddits/searchHeaders
API key (`sfk_...`)
Parameters
Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing (for example `AskReddit`, not `askreddit`). Searches posts within this subreddit.
min 1 chars · max 256 chars
Search text to match against public subreddit posts.
min 1 chars · max 512 chars
Optional sort order for search results. Defaults to relevance when omitted.
one of: relevance, hot, top, new, comments
Optional time range filter for search results. Defaults to all when omitted.
one of: all, year, month, week, day, hour
Opaque pagination cursor returned by a previous response.
min 1 chars
Response fields
Endpoint-specific response payload.
Subreddit name evaluated for this response.
Search query evaluated for this response.
Sort order applied for this response.
one of: relevance, hot, top, new, comments
Time range filter applied for this response.
one of: all, year, month, week, day, hour
Matching posts for the search.
Stable post identifier.
min 1 chars
Post identifier when available.
min 1 chars
Post title.
min 1 chars
Canonical public URL for this post.
min 1 chars
Permalink path or URL for this post.
min 1 chars
Whether the post is marked as adult content.
Whether the post is marked as a spoiler.
Whether the post is a crosspost.
Subreddit metadata when available.
Subreddit identifier when available.
Subreddit name when available.
Whether the subreddit is marked as adult content.
Whether the subreddit is quarantined.
Subreddit icon URL when available.
Subreddit banner URL when available.
Subreddit description when available.
Approximate weekly visitors when available.
≥ 0
Approximate weekly contributions when available.
≥ 0
Engagement metrics for this post.
Vote count when available.
≥ 0
Comment count when available.
≥ 0
ISO-8601 publish timestamp when available.
Thumbnail image URL when available.
Whether the thumbnail is blurred.
Position of this row in the current result page.
≥ 0
Relative position of this row in the current result page.
≥ 0
Number of post rows returned in this response.
≥ 0
Pagination information for the current response.
Cursor to pass in the next request when another page exists.
Whether another page of results is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Search results for the requested subreddit.
Error codes