Search Reddit
Returns posts, subreddits, users, or comments matching required keyword. Optional fields choose result type, ordering, time range, content safety, and pagination.
2 credits / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
keyword*string
Keyword to search Reddit for.
Length
1 <= lengthsearch_type?string
Type of result to search for.
Value in
- "post"
- "community"
- "comment"
- "media"
- "people"
sort?string
Sort order for search results (applies to post/comment/media search_type only).
Value in
- "RELEVANCE"
- "HOT"
- "TOP"
- "NEW"
- "COMMENTS"
time_range?string
Time window to restrict search results to (applies to post/media search_type only).
Value in
- "ALL"
- "HOUR"
- "DAY"
- "WEEK"
- "MONTH"
- "YEAR"
safe_search?string
Safe search filtering level.
Value in
- "unset"
- "strict"
allow_nsfw?string
Whether to include NSFW results (0 = no, 1 = yes).
Value in
- "0"
- "1"
after?string
Cursor from the previous response used to fetch the next page.
curl -X GET "https://example.com/v2/reddit/search?keyword=cats" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "components": { "__typename": "string", "main": { "items": [ null ], "pageInfo": { "property1": null, "property2": null } } } }}