Search Reddit subreddit
Search posts within one subreddit (not site-wide — use reddit.search.list for that).
Headers
Get your API keyAPI key (`sfk_...`)
Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. 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
Sort order for search results. Default: `relevance`.
one of: relevance, hot, top, new, comments
Time range filter for search results. Default: `all`.
one of: all, year, month, week, day, hour
Opaque pagination cursor returned by a previous response.
min 1 chars
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/reddit/subreddits/search?subreddit=Fitness" \
-H "x-api-key: YOUR_API_KEY"Responses
Search results for the requested subreddit.