ToolzerHub Docs

Search Reddit (v1)

Search Reddit posts, communities, comments, people, or media and return results in ranked order.

1 credit / requestBilled only on success
GET
/v1/reddit/search

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"
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.

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": 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"  }}