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

> Searches for posts within a specific subreddit. Returns matching posts with titles, scores, comment counts, and permalinks.

TL;DR: `GET /v1/reddit/subreddit/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 |
| --- | --- | --- |
| `subreddit` | yes | Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL) |
| `query` | no | Search query to find matching content |
| `sort` | no | Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new (relevance \| hot \| top \| new \| comments) |
| `timeframe` | no | Timeframe to filter results (all \| year \| month \| week \| day \| hour) |
| `cursor` | no | Cursor to get more results. Get 'cursor' from previous response. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/reddit/subreddit/search?subreddit=technology" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search within a specific subreddit?

Send a GET request to /v1/reddit/subreddit/search with the subreddit name (no r/ prefix) as the required subreddit parameter. Add your keyword in the optional query parameter to filter — omit it to browse the subreddit as-is. Results are scoped to that subreddit only.

### How is this different from the Reddit Search API?

The top-level /v1/reddit/search runs across all of Reddit. This endpoint scopes results to one subreddit — better signal for community-specific brand monitoring, competitor tracking in niche subreddits, or pulling discussion on a product in r/SaaS.

### What sort and timeframe options are supported?

sort accepts relevance, hot, top, new, and comments. timeframe accepts hour, day, week, month, year, and all. Pair sort=top with timeframe=week to get the highest-scoring posts on a topic inside a subreddit this week.

### How do I paginate subreddit search results?

The response includes a cursor token. Pass it as the cursor parameter on the next request to fetch the next page. Repeat until cursor is empty to walk through the full result set inside that subreddit.

### How much does the Subreddit Search API cost?

Each search costs 1 credit on the standard tier, regardless of how many posts match. New accounts get 100 free credits with no credit card required — enough to run 100 scoped searches across your most important subreddits.

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 to search within a specific subreddit using an API
- Scoped brand monitoring on Reddit with SocialCrawl