Redreach API

The Reddit marketing API
for whatever you build next

Every thread worth replying to, every brand mention with sentiment, every subreddit that matters for your project. Clean, paginated JSON you can pipe into dashboards, Slack reports, spreadsheets or your own agents.

Get your API key Browse the endpoints
Bearer auth JSON responses Paginated Relevance-scored Rate limited
keyword opportunities · curl
$ curl "https://connect.redreach.ai/api/v1\
/projects/proj_7k2m9dq4tv8xw/keyword-opportunities" \
  -H "Authorization: Bearer rr_…"

{
  "data": [{
    "title": "is limiting charge to 80% good for…",
    "subreddit": "macbookpro",
    "relevanceScore": 98,
    "relevanceReason": "OP asks exactly the
      question your product answers…",
    "matchedKeywords": ["mac battery health app"]
  }, …],
  "meta": { "pagination": { "page": 1, "total": 103 } }
}

01 · Quickstart

First response in three requests

One Bearer key, plain HTTPS, JSON in and out. No SDK required and nothing to install.

1 · Create an API key

Under Settings → API. It looks like rr_…, is shown once, and works for both the REST API and the MCP server.

Create API key

2 · List your projects

Every other call takes a project id. This returns the projects your key can see, each with an id that looks like proj_… plus competitors, plan and monitoring status.

curl -s https://connect.redreach.ai/api/v1/projects \
  -H "Authorization: Bearer rr_YOUR_KEY"

3 · Pull opportunities

Threads matching your tracked keywords, newest first, each with a relevance score and the reasoning behind it.

curl -s "https://connect.redreach.ai/api/v1/projects/PROJECT_ID/keyword-opportunities?page=1&limit=20&sortBy=relevance" \
  -H "Authorization: Bearer rr_YOUR_KEY"

02 · Endpoint reference

Every endpoint on one page

Everything an API key can reach. Paths are relative to https://connect.redreach.ai/api/v1, list endpoints take page and limit, and every response comes back as clean JSON with a pagination envelope. Keys read and track, nothing more: no billing, no account changes, no key management.

Discover
GET/projects

Your projects with their ids (they look like proj_…), competitors, plan status and monitoring health. Call this first.

GET/projects/{project}/keyword-opportunities

Fresh threads caught by keyword monitoring, each with a relevance score and the reasoning behind it.

GET/projects/{project}/serp-opportunities

Reddit threads ranking on Google for your keywords, with position, search volume and intent flags.

GET/threads?url={reddit thread url}

Full post text of a thread Redreach has indexed.

GET/projects/{project}/keywords

The keywords Redreach tracks for the project.

Monitor
GET/projects/{project}/mentions

Threads mentioning your brand, with per-comment sentiment and a distribution summary. Pass target=competitor for competitor mentions.

GET/projects/{project}/subreddit-insights

Which subreddits hold the most opportunity: thread counts, average relevance, search demand.

GET/projects/{project}/reply-context

Company identity, saved prompts and drafting guidelines: everything your own model needs to write replies in your voice.

Track
GET/projects/{project}/handled

Threads already marked replied or ignored, so scripts and agents skip handled work.

POST/projects/{project}/handled

Mark a thread replied or ignored. It disappears from every teammate's queue immediately.

GET/me

Check your key is valid and see which account it belongs to.

Outreach CRM
GET/projects/{project}/leads

Your DM leads with status, timeline, tags and campaign. Params: view (outreach|prospects|all), status, responded, campaign, list, search.

GET/projects/{project}/lead-lists

Your DM lead lists with member counts.

GET/projects/{project}/campaigns

Your DM campaigns with status and type.

GET/projects/{project}/crm-insights

Funnel stats: contacted, response rate, won deals, DMs sent today, plus when the CRM last synced.

03 · Auth & limits

Simple auth, clear limits

One Bearer header, per-user scoping enforced server-side, and rate limits that always tell you exactly where you stand.

One Bearer header

Send Authorization: Bearer rr_… on every request. Keys are per-user, shown once at creation, and only ever see the projects their owner can see.

Clear rate limits

120 requests per minute and 2,000 per hour per key. Every response carries RateLimit-* headers, and a 429 tells you exactly how long to wait via Retry-After.

Revoke in one click

Kill a key in Settings → API and it stops working within a minute, across both the REST API and the MCP server. Keys can't touch billing or mint other keys.

Working with an AI agent instead of code?

The same key powers the Redreach MCP server: the agent-friendly layer over these endpoints for Claude, Cursor, Codex and any Streamable HTTP client.

MCP server

Included on Growth, Professional and Agency

No metered API pricing and no separate bill. Keys use the same account, projects and limits you already have, and stop working if the subscription lapses.

See plans
Get Customers From Reddit

FAQ

The Reddit API for marketers, answered

No. Reddit's official API gives you raw, unfiltered access to Reddit itself. You still have to find the needles. The Redreach API serves the finished product of our monitoring: threads that rank on Google for your keywords, fresh threads scored for relevance to your business with the reasoning attached, and brand or competitor mentions with sentiment. If your question is "what should we do on Reddit this week?", this is the API that answers it directly.
Anything that consumes JSON: an internal dashboard, a weekly Slack or Notion report, a Google Sheet your team triages, a Zapier or n8n workflow, enrichment for your CRM, or a custom agent. One customer pattern we designed for: pull opportunities each morning, post the top five to a Slack channel, and mark threads handled from there via POST /v1/projects/{project}/handled.
Create a key under Settings → API and send it as a Bearer token: Authorization: Bearer rr_…. Keys are hashed server-side (we can't read them back), shown once at creation, scoped to their owner's projects, and revocable at any time. There are no OAuth dances for server-to-server use.
120 requests per minute and 2,000 per hour per key. That's generous for reports and dashboards, since list endpoints return up to 50 items per page. Every response includes RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers, and a 429 comes with Retry-After.
No, and it never will. The API is read-and-track: it finds conversations, explains why they matter, and records what your team handled. Posting stays with a human on their own Reddit account. Automated posting is the fastest way to get banned, so we don't offer it on any surface.
The building blocks are there today: GET /v1/projects/{project}/reply-context returns your company description, saved prompts, tone templates and drafting guidelines, so your own model (or agent) can draft replies in your voice. A server-side generation endpoint is rolling out together with comment credits.
Yes. One rr_ key authenticates both surfaces. The MCP server is the agent-friendly layer for Claude, Cursor and Codex; the REST API is the same data for code. Use whichever fits the job. Revoking the key kills both.
Yes, read-only: leads with their full status timeline, lead lists, campaigns and funnel insights. One thing to know: lead data is collected by the Redreach Chrome extension while it is open on your machine, so the API reads what the extension last synced. The insights endpoint reports lastActivityAt and includes a note when data has gone stale, so your dashboard or agent can prompt you to open the extension. Adding leads to lists via the API is on the roadmap.
The REST API and MCP server are included on Growth, Professional and Agency plans at no extra charge, with no metered API pricing. If the subscription lapses, keys stop working until it's renewed.

Get Customers from Reddit

Redreach is a Reddit marketing tool that identifies highly relevant conversations, enabling you to naturally promote your product, monitor brand and competitor mentions, and generate quality leads from Reddit traffic.

Get Started Today →

Pricing

Pricing that
pays for itself

Ads can cost you thousands of dollars. Redreach discovers hidden opportunities on Reddit and drives organic growth for the fraction of the cost. Literally pays itself if you get a single new customer.

Redreach is the
#1 Reddit Marketing Tool for...

Lead Generation Auto DM Outreach AI SEO Reddit Comment Marketing Parasite SEO AI Reddit Keyword Tracking Brand Mentions Competitor Monitoring Notifications for Reddit