Search Reddit posts
Search for posts on Reddit.
Use `data.page.hasMore` and `data.page.nextCursor` for pagination rather than inferring completion from `data.totalResults` alone.
Headers
Get your API keyAPI key (`sfk_...`)
Search query text for public Reddit posts.
min 1 chars · max 512 chars
Optional sort order for search results.
one of: relevance, new, top
Optional time range filter for search results.
one of: all, day, week, month, year
Opaque pagination cursor returned by a previous response.
min 1 chars
Whether to request a smaller response shape when available.
Endpoint-specific response payload.
Search query string evaluated for this response.
Posts returned for this page.
Stable post identifier.
min 1 chars
Full post name when available.
Post title when available.
Author username when available.
Subreddit name without a leading r/ when available.
Prefixed subreddit label such as r/example when available.
Canonical public post URL when available.
Public permalink URL when available.
Post body text when available.
Post score when available.
≥ 0
Upvote count when available.
≥ 0
Upvote ratio between 0 and 1 when available.
≥ 0 · ≤ 1
Comment count when available.
≥ 0
ISO-8601 creation timestamp when available.
Whether the post is a video post.
Subreddit subscriber count when available.
≥ 0
Number of posts 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
curl "https://api.socialfetch.dev/v1/reddit/search?query=web scraping" \
-H "x-api-key: YOUR_API_KEY"Responses
Search results for the requested query.