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

> Searches Reddit for posts matching a keyword query. Returns a list of matching posts with titles, scores, comment counts, subreddit names, and permalinks.

TL;DR: `GET /v1/reddit/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 | Search keyword or phrase to find Reddit posts |
| `sort` | no | Sort by (relevance \| new \| top \| comment_count) |
| `timeframe` | no | Timeframe (all \| day \| week \| month \| year) |
| `after` | no | Used to paginate to next page |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

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

## FAQ

### How do I search Reddit posts with an API?

Send a GET request to /v1/reddit/search with your query in the query parameter. SocialCrawl searches across all of Reddit and returns matching posts with title, score, comment count, subreddit, author, permalink, and timestamp.

### What sort options does Reddit search support?

Four sort modes: relevance (default), new, top, and comment_count. Pair sort=top with a timeframe (day, week, month, year, all) to pull the highest-scoring posts from a specific period. Useful for trend analysis and brand tracking.

### Can I monitor brand mentions across Reddit?

Yes. Run the search endpoint on a cron with your brand name or product keywords as the query, sort by new, and ingest the result into your monitoring pipeline. No Pushshift downtime and no Reddit app registration required.

### How do I paginate through search results?

The response includes an after token. Pass that value as the after parameter on the next request to fetch the next page. Repeat until after is empty to walk through the full result set beyond the default page size.

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

Each search request costs 1 credit on the standard tier, regardless of how many results come back. New accounts get 100 free credits with no credit card required. Pass trim=true to receive a slimmer response when you only need core fields.

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 Reddit for brand mentions with an API
- What does the SocialCrawl Reddit Search API return?