RedditGrow REST API v1

54+ JSON endpoints across Reddit opportunities, AI replies, cold DMs, SEO/SERP intel, AI visibility, brand monitoring, a 10-day warmup roadmap, webhooks and autopilot. Bearer API-key auth, cursor pagination, the same quotas as the dashboard.

Sign up to get startedView pricing

Growth or Agency plan required

Authentication

Every request needs an API key in the Authorization header. Generate a key in Settings → Integrations (key shown once, format rg_live_…). API access requires the Growth or Agency plan.

Base URL & auth

Base URL   https://redditgrow.ai/api/v1
Header     Authorization: Bearer rg_live_YOUR_KEY_HERE

Quick start

List today's opportunities

curl "https://redditgrow.ai/api/v1/opportunities?min_score=70&limit=10" \
  -H "Authorization: Bearer rg_live_YOUR_KEY_HERE"

Generate a reply for one opportunity

curl -X POST "https://redditgrow.ai/api/v1/responses/generate" \
  -H "Authorization: Bearer rg_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"opportunity_id":"<uuid>","tone":"helpful","length":"medium"}'

Conventions

Pagination

List endpoints return { data: [...], next_cursor }. Pass ?cursor= to fetch the next page; next_cursor: null means you've reached the end.

Errors

Errors return { error: { code, message } } with the right HTTP status — e.g. 401 invalid_key, 403 plan_not_supported.

Rate limits

Growth: 100 calls / hour. Agency: 500 calls / hour. Over the limit returns 429 rate_limited with a Retry-After header.

Quotas

Generating replies, posts or DMs counts against the same monthly AI quota as the dashboard — tracked atomically, so the API can't bypass it.

Endpoints

16 groups · 54 endpoints. All paths are relative to https://redditgrow.ai/api/v1.

Opportunities & replies

The core loop — what to respond to, and how.

  • GET/opportunities
    list top-scored opps (min_score, subreddit, status, since_hours; cursor-paginated)
  • GET/opportunities/{id}
    full post + author + scoring breakdown
  • POST/opportunities/{id}/mark
    mark one opp done / dismissed
  • POST/opportunities/mark-bulk
    mark many opps at once
  • POST/responses/generate
    Reddit-rules-aware reply (tones × short|medium|long)
  • POST/responses/generate-bulk
    up to 10 replies in one call
  • POST/responses/variants
    2–5 A/B variants for one opportunity
  • POST/responses/{id}/outcome
    log karma earned on a posted reply
  • GET/responses/winning-patterns
    which tone × length wins for you
  • GETPOST/drafts
    list / persist edited drafts
  • POST/posts/generate
    draft a NEW Reddit thread (not a reply)

Cold DM outreach

Generate, queue and track DM sequences with built-in safety + cooldowns.

  • POST/dm/generate
    ice-breaker from an opp (cold | pain | social_proof)
  • POST/dm/queue
    schedule a draft with human-like cooldowns
  • POST/dm/messages/{id}/cancel
    pull back a scheduled DM
  • GET/dm/prospects
    review the outreach pipeline
  • GET/dm/stats
    sent today, daily limit, scheduled, active

Brand & competitor mentions

Reddit posts that mention your brand or your competitors.

  • GET/brand-mentions
    filter by project / mention_type / sentiment / unseen
  • POST/brand-mentions/{id}/mark
    mark a mention addressed / seen

SEO / SERP / AI visibility

Optimize for Google + AI Overviews via Reddit.

  • POST/seo/serp-rank
    live Google SERP — which threads rank for a keyword
  • GET/seo/ranking-opps
    your opps that already rank
  • GET/seo/money-keywords
    money keywords with rank, volume, difficulty
  • GET/seo/gap
    highest-leverage SEO gaps to target
  • POST/seo/ai-visibility
    0–100 brand-visibility score for LLM citations
  • GET/llm-citations/trend
    AI citation trend over time

Roadmap / daily plan

Day-by-day warmup roadmap (10 days, ~35 items).

  • GET/roadmap
    today / week plan with progress
  • POST/roadmap/{itemId}/mark
    completed | skipped | pending
  • POST/roadmap/regenerate
    rebuild pending items (history preserved)

Automation

One call that returns the prioritized next action.

  • GET/automation/next-action
    ranked recommendation across every signal

Projects & Reddit accounts

Multi-project + multi-account for Agency users.

  • GETPOST/projects
    list / create projects (brands you market)
  • GET/reddit-accounts
    connected Reddit accounts (read-only)
  • POST/reddit-accounts/active
    switch the active account

Tracked subreddits

Full CRUD on your monitoring list.

  • GETPOST/subreddits/tracked
    list / add a tracked sub
  • PATCHDELETE/subreddits/tracked/{id}
    pause/resume + gates / soft-delete

Subreddit discovery & analysis

Pick where to post and when.

  • GET/subreddits/discover
    find subs relevant to a topic
  • GET/subreddits/analyze
    subscriber count, rules, promotion stance
  • GET/subreddits/best-times
    top engagement time slots (UTC heatmap)
  • GET/subreddits/suggested-from-keywords
    suggestions from your keywords

Live Reddit access

Ad-hoc Reddit search + post + user lookups.

  • GET/reddit/search
    full-text search across Reddit
  • GET/reddit/posts/{subreddit}/{postId}
    one post + its comments
  • GET/reddit/users/{username}
    profile + recent posts/comments

Account health & warmup

Is your account safe to post today?

  • GET/warmup/status
    quick check: posts remaining today
  • GET/warmup/health
    detailed report — tier, karma, flags, recs

Templates

Reusable tone + length + angle presets.

  • GETPOST/templates
    list / save a preset
  • DELETE/templates/{id}
    remove a preset

Webhooks

Get notified outside of Reddit (HMAC-signed).

  • GETPOST/webhooks
    list / subscribe — POST on opportunity.created
  • POST/webhooks/{id}/test
    fire a test event to your endpoint
  • DELETE/webhooks/{id}
    remove a webhook

RSS monitoring

Monitor any subreddit or search as an RSS feed.

  • GETPOST/rss/subscriptions
    list / subscribe to a feed
  • DELETE/rss/subscriptions/{id}
    remove a subscription
  • GET/rss/hits
    recent matches across your feeds

Conversational setup

Spin up a project from a URL or a free-text pitch.

  • POST/setup/analyze-landing
    scrape + AI-analyze a URL
  • POST/setup/suggest-subreddits
    suggest subs from a pitch (no URL)
  • POST/setup/from-landing
    one-shot: scrape + analyze + create + track

Analytics

Engagement & performance metrics for your workspace.

  • GET/analytics
    engagement, karma and conversion metrics

FAQ

Which plans include API access?

The Growth ($39/mo) and Agency ($99/mo) plans include API + MCP + CLI. Founder Pack is not eligible.

Is the API key the same one used by MCP and the CLI?

Yes — one rg_live_… key works for the REST API, the MCP server and the CLI. Manage and revoke keys in Settings → Integrations.

Does the API post to Reddit directly?

Replies and posts come back as drafts — you post them manually on Reddit. Cold DMs are queued through the same human-like scheduler the dashboard uses (daily caps + cooldowns), and the worker delivers them via the Reddit API on your behalf. Both paths respect Reddit ToS.

Are webhooks signed?

Yes — every delivery includes X-RedditGrow-Signature (HMAC-SHA256 of the JSON body). Dead endpoints auto-disable after several consecutive failures.

Prefer to work inside your AI assistant or the terminal? The same 54+ capabilities ship as an MCP server and a CLI.

View MCP setupView CLI setup