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

# Subreddit Search

`GET /v1/scrape/reddit/subreddit/search`

## Request

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

Search within a subreddit for posts, comments, or media matching a query

## Query parameters

- `subreddit` string, required
- `query` string
- `filter` 'posts' | 'comments' | 'media'
- `sort` 'relevance' | 'hot' | 'top' | 'new' | 'comments'
- `timeframe` 'all' | 'year' | 'month' | 'week' | 'day' | 'hour'
- `cursor` string

## Response `200`

Successful response with search results

## Other responses

- `400`: Bad Request - Missing or invalid parameters
- `402`: Payment Required - Insufficient credits

---

[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)