Search Reddit | Reddit API

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.

Length1 <= length <= 500

type?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"

count?integer

How many distinct results to return. Pages are walked for you. This endpoint has no usable cursor, so raise count to go deeper. type=people returns one short page.

Range1 <= value <= 200

Default25

cursor?string

Optional cursor taken from Reddit itself. This endpoint returns no next_cursor; use count to control depth.

Length1 <= length <= 8000

curl -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": 25,    "requested_count": 25,    "next_cursor": null,    "end_of_feed": false,    "pages_fetched": 4,    "usage_note": "Search pages are small (7-14 results) and repeat across pages, so `count` counts distinct results. Search records are genuinely thinner than feed rows — Reddit renders them as SDUI markup with no post elements at all, so score and comment count come from the visible counter row and are null wherever the renderer omits it (all media results, for instance). type=people returns one short page and then no cursor; a small result there is the corpus, not an error. Raise `count` to go deeper — the cursor is not exposed because it cannot be re-aimed at a trimmed list."  }}