# Reddit Omni Search API (https://www.socialcrawl.dev/platforms/reddit/omni-search)

> Runs reddit/search, expands the top N threads' comments in parallel (capped 15/thread), and rolls up which subreddits are talking — volume + a per-community tone label. Returns sync JSON or a typed SSE stream that emits each thread as its comments land. Metered at 1 credit per search page + 1 credit per successfully-expanded thread (minimum 5); a failed thread isn't billed and the unused thread ceiling is refunded. `subreddit=` scopes the sweep to one community. The `next_cursor` resumes the search. Honest note: Reddit search is the slowest social search on the API (10–12s) and relevance is loose — a VoC sweep, not precision ranking.

TL;DR: `GET /v1/reddit/omni-search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Keyword or phrase to sweep across Reddit. |
| `threads` | no | How many top threads to expand comments for (1–8, default 8). |
| `sort` | no | Search sort order (relevance \| new \| top \| comment_count). (relevance \| new \| top \| comment_count) |
| `timeframe` | no | Time window for the search (all \| day \| week \| month \| year). (all \| day \| week \| month \| year) |
| `subreddit` | no | Scope the sweep to one subreddit (bare name, no r/ prefix). |
| `cursor` | no | Opaque cursor from a prior response's next_cursor to page deeper. |
| `include` | no | CSV subset of subreddits,comments (default both). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/reddit/omni-search?query=best%20mechanical%20keyboard" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search all of Reddit with one API call?

Send GET /v1/reddit/omni-search?query=<keyword> with your API key. SocialCrawl's Reddit search API runs the search, expands the top threads' comments in parallel, and rolls up which subreddits are talking — so you get threads, attribution, and top comments in one response.

### Does the Reddit search API include comments?

Yes. Each thread comes back with its top comments nested inline (capped at 15 per thread). Set threads to control how many of the top results get their comments expanded (1–8, default 8), or pass include=subreddits to skip comment expansion.

### Can I scope the sweep to one subreddit?

Yes. Pass subreddit=MechanicalKeyboards (bare name, no r/ prefix) and the search runs scoped to that community. The response's subreddits rollup then collapses to that one subreddit with its thread count and tone.

### How much does a Reddit search sweep cost?

It is metered: 1 credit per search page plus 1 credit per thread whose comments are expanded, with a 5-credit minimum. A failed thread is not billed, and the unused thread budget is refunded, so you only pay for what actually lands.

### Why is the Reddit sweep slower than other searches?

Reddit search is the slowest social search on the API — typically 10–12 seconds — and its relevance is loose, so treat it as a voice-of-customer sweep, not precision ranking. Send Accept: text/event-stream to stream each thread as its comments land.

See the full Reddit API: https://www.socialcrawl.dev/platforms/reddit

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I search all of Reddit for a keyword with one API call?
- What does SocialCrawl's reddit/omni-search return?