---
title: "Subreddit Posts"
method: GET
path: "/v1/reddit/subreddit"
tags: ["Reddit"]
---

# Subreddit Posts

`GET /v1/reddit/subreddit`

Fetches posts from a subreddit with sorting and filtering options. Each post includes title, author, link_flair_text when Reddit exposes it, selftext, score, ups, upvote_ratio, num_comments, created_utc, url, permalink, subreddit_subscribers, and is_video. Supports sort (best, hot, new, top, rising), timeframe filtering, pagination via the after token, and a trim parameter for lighter responses.

## Query parameters

- `subreddit` string, required
- `timeframe` 'all' | 'day' | 'week' | 'month' | 'year'
- `sort` 'best' | 'hot' | 'new' | 'top' | 'rising'
- `after` string
- `trim` boolean
- `cache_max_age` '1d' | '3d' | '7d' | '14d' | '30d'

## Response `200`

Successful response

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) · [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapecreators/scrape-creators-api/revisions/e9ec3dbbd8b8/schema)