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

# Subreddit Posts

`GET /v1/scrape/reddit/subreddit`

## Request

- Base URL: `https://api.sociavault.com`
- URL: `https://api.sociavault.com/v1/scrape/reddit/subreddit`
- Auth: API key in header `X-API-Key`

Get recent posts from a subreddit with engagement metrics

## Query parameters

- `subreddit` string, required
- `timeframe` 'all' | 'day' | 'week' | 'month' | 'year'
- `sort` 'best' | 'hot' | 'new' | 'top' | 'rising'
- `after` string
- `trim` boolean

## Response `200`

Successful response

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error - Service configuration or processing error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)