Search Reddit (v1)
Search Reddit posts, communities, comments, people, or media and return results in ranked order.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
q*string
What to search for. Required, and the only parameter search actually needs — everything else selects a corpus or a depth.
Reddit's own query syntax is passed through untouched; nothing here rewrites, stems or quotes it.
Length
1 <= length <= 500type?string
What to search: posts (default), communities, comments, people or media. Each row states its kind. people returns a single short page. media rows are posts with null score and comment_count.
Default
"posts"Value in
- "posts"
- "communities"
- "comments"
- "people"
- "media"
cursor?string
next_cursor from the previous response; omit for the first page. It is Reddit's own token and stays valid for at least ~20 minutes.
Length
1 <= length <= 8000curl -X GET "https://example.com/v1/reddit/search?q=chatgpt" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "results": [ { "kind": "post", "id": "1vay198", "fullname": "t3_1vay198", "title": "Example post title", "permalink": "/r/technology/comments/1vay198/example/", "author": "example_user", "author_id": "t2_abc123", "subreddit": "technology", "subreddit_id": "t5_2qh16", "created_at": "2026-08-17T09:14:22.000+0000", "score": 1284, "comment_count": 213, "nsfw": false, "spoiler": false, "subreddit_nsfw": false, "snippet": null, "snippet_fullname": null, "media": null } ], "query": "chatgpt", "type": "posts", "count": 7, "next_cursor": "eyJwaXBlbGluZSI6...", "end_of_feed": false, "usage_note": "One Reddit search page: 7 results for posts and media, 10 for communities, 8-14 for comments. Pass `next_cursor` as `cursor` for the next page. Score and comment count are null where Reddit's search markup omits them (all media results). type=people is a single short page." }, "details": { "reason": "no_results", "message": "string" }}