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

> Returns a list of top posts from a subreddit. Each post includes the title, score, upvote ratio, comment count, author, flair, permalink, and creation timestamp.

TL;DR: `GET /v1/reddit/subreddit` 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 without the r/ prefix |
| `timeframe` | no | Timeframe to get posts from. Applied with sort=top (auto-selected when you omit sort). (all \| day \| week \| month \| year) |
| `sort` | no | Sort order (best \| hot \| new \| top \| rising) |
| `after` | no | After to get more posts. Get 'after' from previous response. |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

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

## FAQ

### How do I list posts from a subreddit?

Send a GET request to /v1/reddit/subreddit with the subreddit name (without the r/ prefix). SocialCrawl returns an array of posts including title, score, upvote ratio, comment count, author, flair, permalink, and creation timestamp.

### What sort options does the subreddit endpoint support?

Five sort modes: best, hot, new, top, and rising. Pair sort=top with a timeframe (day, week, month, year, all) to pull historical top posts. Default is the subreddit's canonical ordering when no sort is passed.

### How do I paginate through older subreddit posts?

Take the after token from the response and pass it as the after parameter on the next request. Repeat until after is empty to walk through the full post history beyond Reddit's default page size.

### Can I get posts from a private or quarantined subreddit?

No. SocialCrawl reads only public subreddit data. Private, quarantined, or user-banned subreddits return an empty result. Use the subreddit/details endpoint first to confirm a subreddit is public before pulling posts.

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

Each request costs 1 credit on the standard tier. New accounts get 100 free credits — enough to pull around 100 subreddit snapshots before you pay. Add trim=true for 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 list hot or top posts from a subreddit with an API
- What does the SocialCrawl Subreddit Posts API return?