Headers
Get your API keyAPI key (`sfk_...`)
Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Lists posts for this subreddit.
min 1 chars · max 256 chars
Optional sort order for the returned posts.
one of: best, hot, new, top, rising
Optional timeframe used with time-based sort orders.
one of: all, day, week, month, year
Opaque pagination cursor from a previous response (`data.page.nextCursor`).
min 1 chars
Endpoint-specific response payload.
Whether the subreddit resolved for this request.
one of: found, not_found
Posts returned for the requested subreddit. This array may be empty when the subreddit resolves but no posts are returned.
Stable identifier for the post.
min 1 chars
Full post identifier when available.
Subreddit name for this post when available.
Post title.
min 1 chars
Text body of the post when available.
Post author.
Post author username when available.
Stable author identifier when available.
Canonical public URL for this post when available.
Permalink URL for this post when available.
ISO-8601 timestamp for when the post was published.
Post metrics.
Post score when available.
≥ 0
Upvote count when available.
≥ 0
Upvote ratio when available.
≥ 0
Comment count when available.
≥ 0
Crosspost count when available.
≥ 0
Subreddit subscriber count when available.
≥ 0
Post content flags.
Whether the post is a video.
Whether the post is pinned.
Whether the post is locked.
Whether the post is marked as a spoiler.
Whether the post is marked as adult content.
Whether the post is marked as original content.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of posts can be requested.
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
curl "https://api.socialfetch.dev/v1/reddit/subreddits/AskReddit/posts?sort=best" \
-H "x-api-key: YOUR_API_KEY"Responses
Subreddit posts for the requested feed. Check `data.lookupStatus` for `found` vs `not_found`.