# Search Reddit

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

- Platform: Reddit
- Request: `GET https://api.toolzerhub.com/v1/reddit/search`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/reddit/search/get-reddit-search-v2

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `q` | query | yes | 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. |
| `type` | query | no | enum: posts, communities, comments, people, media | 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. |
| `count` | query | no | 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. Default: 25. |
| `cursor` | query | no | string | Optional cursor taken from Reddit itself. This endpoint returns no next_cursor; use count to control depth. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/reddit/search?q=<q>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.