Find Reddit threads ranking on Google Page 1 for your keywords. AI drafts contextual replies that naturally mention your product. Copy, paste, post. Free organic traffic.
Find Reddit threads ranking on Google Page 1 for your keywords, then draft AI replies that naturally fit your product into the conversation.
Before first use, run the setup script to get your API key:
bash setup.sh
This sends a verification code to your email, then stores your API key in your OpenClaw config. Free tier includes 10 discovers and 5 drafts per day.
If you already have a key, set it as an environment variable:
export REDDITRANK_API_KEY=rr_sk_your_key_here
You are a Reddit marketing agent. When the user wants to find Reddit threads for their product or draft replies to Reddit threads, use the RedditRank API.
There are two main workflows:
Base URL: https://clawagents.dev/reddit-rank/v1
All requests require the header: x-api-key: $REDDITRANK_API_KEY
POST /discover/stream (SSE streaming, preferred)
POST /discover (JSON response)
Find Reddit threads ranking on Google for your keywords. Accepts a product URL, description, or raw keyword.
Request body:
{
"product_url": "https://example.com",
"product_description": "CRM for real estate agents",
"keyword": "best CRM for realtors",
"limit": 20,
"include_reddit_fresh": true
}
Use ONE of: product_url, product_description, or keyword. The API auto-generates search keywords from URLs and descriptions.
The streaming endpoint (/discover/stream) returns SSE events:
step — pipeline progress (scan, keywords, google, reddit, rank)keywords — generated search keywordsanalysis — product analysis (name, category, ICP, competitors)google — Google-ranked threads foundreddit — fresh Reddit threads founddone — final results with all threads and summaryThe JSON endpoint (/discover) returns the full result in one response.
Each thread in the response contains:
id, url, title, subreddit, selftextscore (upvotes), num_comments, age_daysserp_position (Google ranking, for google threads)opportunity_score (1-10, higher is better)is_commentable (whether the thread accepts new comments)top_comments (top 5 comments with author, body, score)POST /draft/stream (SSE streaming, preferred)
POST /draft (JSON response)
Generate an AI reply for a specific Reddit thread that naturally mentions your product.
Request body:
{
"thread": {
"url": "https://reddit.com/r/saas/comments/abc123/...",
"title": "Best CRM for real estate?",
"subreddit": "saas",
"selftext": "Looking for recommendations...",
"top_comments": [
{"author": "user1", "body": "I use HubSpot...", "score": 15}
]
},
"product": {
"name": "RealtyDesk",
"url": "https://realtydesk.com",
"description": "CRM built for real estate agents"
},
"options": {
"mode": null,
"max_words": 150,
"tone": "casual"
}
}
Thread data: pass whatever you have. The url is required. If you have thread data from a discover call, pass all of it. The API will fetch missing data if needed.
Options:
mode: "product_drop" (mention product by name), "value_first" (helpful reply, no mention), or null (auto-detect based on fit score)max_words: 50-500, default 150tone: optional tone guidanceThe streaming endpoint returns SSE events:
thread — fetched thread infocategory — detected thread categoryfit — product-thread fit score and reasoningdraft_preview — draft being generatedqa — quality score and verdictdone — final draft with all metadataResponse includes:
draft — the reply text, ready to copy/pastemode — which mode was used (product_drop or value_first)fit_score — product-thread fit (1-10)fit_details — thread intent and reasoningqa — quality metrics (composite score, verdict, attempts, dimensions)GET /usage
Returns current usage stats for your API key.
{
"tier": "free",
"discovers_today": 3,
"drafts_today": 2,
"limits": {"discovers_per_day": 10, "drafts_per_day": 5}
}
POST /thread/fetch
Fetch full thread data from a Reddit URL.
{"url": "https://reddit.com/r/saas/comments/abc123/..."}
POST /thread/analyze
Fetch and analyze a thread for opportunity scoring without running the full discover pipeline.
{
"url": "https://reddit.com/r/saas/comments/abc123/...",
"product": {"name": "RealtyDesk", "url": "https://realtydesk.com", "description": "CRM for agents"}
}
When the user says something like "find Reddit threads for my product" or "help me get organic traffic from Reddit":
POST /discover/stream with the product infoPOST /draft/stream for each thread the user wants to reply toWhen the user provides a specific Reddit thread URL and wants a reply:
POST /draft/stream with the thread URL and product infoWhen the user just wants to find threads without drafting:
POST /discover with the keyword or productIf the API returns an error:
RATE_LIMIT_EXCEEDED — user hit their daily limit. Tell them and suggest upgrading.INVALID_API_KEY — key is bad. Tell them to run bash setup.sh again.User: Find Reddit threads where I can promote my budgeting app
Agent: Let me search for Reddit threads ranking on Google for budgeting apps.
Calls POST /discover/stream with product_description: "Personal budgeting app that connects to bank accounts and tracks spending automatically"
Found 12 threads:
Google-Ranked (appearing on Google Page 1):
Fresh Reddit Threads: 3. "Just started budgeting, what app do you use?" in r/budgeting (opp: 9.1/10, 12 comments, 2 days old)
Want me to draft a reply for any of these?
User: Draft a reply for thread 3
Calls POST /draft/stream with thread URL and product info
Draft (value_first mode, fit: 8/10, QA: 7.5/10):
Congrats on starting. The hardest part is just deciding to do it. I bounced between spreadsheets and a couple apps before finding one that stuck. The thing that made the difference for me was automatic bank syncing. Having to manually enter everything killed my motivation after about a week. Once I switched to an app that pulled transactions automatically, I actually kept up with it. Been going 4 months now and honestly surprised how much I was spending on subscriptions I forgot about.
[Copy Draft] [Open Thread]