> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit

> 6 production-ready jobs — subreddit voice mining, product feedback focus groups, trend-to-content pipelines, AMA-style persona interviews, competitor sentiment tracking, and pain point discovery for messaging

## Overview

Reddit is the internet's largest collection of self-organizing communities, each with a distinct vocabulary and emotional register. These six jobs pull posts, comments, and search results from Reddit's OAuth API into Mavera's surfaces (Brand Voice, Focus Groups, Mave Agent, Speak, Generate) to extract community voice, mirror feedback with synthetic personas, turn trends into content, run AMA interviews, track competitor sentiment, and discover pain points for ad copy.

<Info>
  **Reddit API** — Base URL: `https://oauth.reddit.com/`. Auth: OAuth 2.0 — `Authorization: Bearer {token}` header. Rate limits: 100 requests per minute per OAuth client.
</Info>

***

## Prerequisites

<Steps>
  <Step title="Reddit application credentials">Create a script application at [reddit.com/prefs/apps](https://www.reddit.com/prefs/apps). Record the client ID and client secret.</Step>
  <Step title="User-Agent header">Reddit requires a descriptive `User-Agent` (e.g., `script:your-app:v1.0 (by /u/yourname)`). Requests without one are throttled.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>
  <Step title="Environment variables">`export REDDIT_CLIENT_ID="..."`, `export REDDIT_CLIENT_SECRET="..."`, `export REDDIT_USER_AGENT="script:mavera:v1.0 (by /u/you)"`, and `export MAVERA_API_KEY="mvra_live_xxxxx"`</Step>
</Steps>

***

## Jobs

| # | Job                                                                                 | Reddit Data                 | Mavera Surface          | Output                                 |
| - | ----------------------------------------------------------------------------------- | --------------------------- | ----------------------- | -------------------------------------- |
| 1 | [Subreddit Voice Mining](/integrations/reddit/subreddit-voice-mining)               | /r/{subreddit}/hot          | Brand Voice             | Community voice brand voice            |
| 2 | [Product Feedback Focus Group Mirror](/integrations/reddit/product-feedback-mirror) | /search?q={product}         | Personas + Focus Groups | Synthetic vs real response comparison  |
| 3 | [Trend-to-Content Pipeline](/integrations/reddit/trend-content-pipeline)            | /r/{subreddit}/rising       | Mave Agent + Generate   | Trend-aligned content briefs           |
| 4 | [AMA-Style Persona Interviews](/integrations/reddit/ama-persona-interviews)         | Common AMA questions        | Speak                   | In-depth persona interview transcripts |
| 5 | [Competitor Sentiment Tracking](/integrations/reddit/competitor-sentiment)          | /search competitor mentions | Mave Agent (Chat)       | Sentiment / theme / opportunity map    |
| 6 | [Pain Point Discovery for Messaging](/integrations/reddit/pain-point-messaging)     | Problem threads             | Mave Agent + Generate   | Top 10 pain points → ad copy per point |

***

## Rate Limits & Production Notes

| Reddit Endpoint        | Limit                   | Strategy                      |
| ---------------------- | ----------------------- | ----------------------------- |
| All OAuth endpoints    | 100 req/min             | Track `X-Ratelimit-Remaining` |
| `/search`, `/comments` | Shared 100 req/min pool | Cache; batch by subreddit     |
| Token refresh          | Hourly expiration       | Refresh at 55 min             |

<Warning>
  Reddit enforces **100 req/min**. All code includes 500-700ms delays. For production, implement a token-bucket limiter. Store credentials in env vars. Set descriptive `User-Agent`. Filter `[removed]`/`[deleted]`. Cache locally. Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage).
</Warning>

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="Reddit API Docs" icon="reddit" href="https://www.reddit.com/dev/api/" />

  <Card title="Brand Voice" icon="microphone" href="/features/brand-voice" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />
</CardGroup>