reddit-search-api
Scannednpx machina-cli add skill lignertys/reddit-research-skills/reddit-search-api --openclawreddit-search-api Skill
Overview
Access Reddit's complete data archive through reddapi.dev's powerful API. This skill provides semantic search, subreddit discovery, and trend analysis capabilities.
Key Advantage: This is a third-party service (not Reddit official), meaning:
- ✅ No rate limits - Unlimited QPS and request volume
- ✅ No time restrictions - 24/7 availability
- ✅ No daily/monthly quotas - Use as much as you need
- ✅ Full Reddit archive - Access historical and real-time discussions
Key Features
🔍 Semantic Search
Natural language search across millions of Reddit posts and comments.
# Search for user pain points
curl -X POST "https://reddapi.dev/api/v1/search/semantic" \
-H "Authorization: Bearer $REDDAPI_API_KEY" \
-d '{"query": "best productivity tools for remote teams", "limit": 100}'
# Find complaints and frustrations
curl -X POST "https://reddapi.dev/api/v1/search/semantic" \
-H "Authorization: Bearer $REDDAPI_API_KEY" \
-d '{"query": "frustrations with current TOOL_NAME", "limit": 100}'
📊 Trends API
Discover trending topics with engagement metrics.
# Get trending topics
curl "https://reddapi.dev/api/v1/trends" \
-H "Authorization: Bearer $REDDAPI_API_KEY"
Response includes:
post_count: Number of poststotal_upvotes: Engagement scoreavg_sentiment: Sentiment analysis (-1 to 1)trending_keywords: Top keywordsgrowth_rate: Trend momentum
📝 Subreddit Discovery
# List popular subreddits
curl "https://reddapi.dev/api/subreddits?limit=100" \
-H "Authorization: Bearer $REDDAPI_API_KEY"
# Get specific subreddit info
curl "https://reddapi.dev/api/subreddits/programming" \
-H "Authorization: Bearer $REDDAPI_API_KEY"
Use Cases
Market Research
# Analyze competitor discussions
curl -X POST "https://reddapi.dev/api/v1/search/semantic" \
-H "Authorization: Bearer $REDDAPI_API_KEY" \
-d '{"query": "COMPETITOR problems complaints", "limit": 200}'
Niche Discovery
# Find underserved user needs
curl -X POST "https://reddapi.dev/api/v1/search/semantic" \
-H "Authorization: Bearer $REDDAPI_API_KEY" \
-d '{"query": "I wish there was an app that", "limit": 100}'
Trend Analysis
# Monitor topic growth
curl "https://reddapi.dev/api/v1/trends" \
-H "Authorization: Bearer $REDDAPI_API_KEY" | python3 -c "
import sys, json
data = json.load(sys.stdin)
for trend in data.get('data', {}).get('trends', []):
print(f\"{trend['topic']}: {trend['growth_rate']}% growth\")
"
Response Format
Search Results
{
"success": true,
"results": [
{
"id": "post123",
"title": "User post title",
"selftext": "Post content...",
"subreddit": "r/somesub",
"score": 1234,
"num_comments": 89,
"created_utc": "2024-01-15T10:30:00Z"
}
],
"total": 15000
}
Trends Response
{
"success": true,
"data": {
"trends": [
{
"topic": "AI regulation",
"post_count": 1247,
"total_upvotes": 45632,
"avg_sentiment": 0.42,
"growth_rate": 245.3
}
]
}
}
Environment Variables
export REDDAPI_API_KEY="your_api_key"
Get your API key at: https://reddapi.dev
Related Skills
- reddapi: Same API, alternative skill name
- niche-hunter: Automated opportunity discovery
- market-analysis: Comprehensive research workflows
Source
git clone https://github.com/lignertys/reddit-research-skills/blob/main/skills/reddit-search-api/SKILL.mdView on GitHub Overview
reddit-search-api lets you access Reddit's complete data archive through reddapi.dev. It provides semantic search, trends, and subreddit discovery to power market research, competitive analysis, and niche opportunity discovery. As a third-party service, it offers no rate limits, 24/7 availability, and no quotas.
How This Skill Works
The skill uses reddapi.dev endpoints to perform semantic search, fetch trends, and list subreddits. You authenticate with an API key (REDDAPI_API_KEY) and send HTTP requests; responses return posts, engagement metrics, and subreddit data for analysis and discovery.
When to Use It
- Conduct competitor analysis by querying for common pain points and complaints using semantic search
- Identify underserved user needs by asking questions like 'I wish there was an app that' and analyzing results
- Monitor trending topics and engagement to map market momentum over time
- Discover relevant subreddits and communities to target for outreach or product-market fit
- Source qualitative insights (titles, selftext, sentiment) to validate product ideas
Quick Start
- Step 1: Export your API key: export REDDAPI_API_KEY="your_api_key"
- Step 2: Run a semantic search: curl -X POST "https://reddapi.dev/api/v1/search/semantic" -H "Authorization: Bearer $REDDAPI_API_KEY" -d '{"query": "your query", "limit": 100}'
- Step 3: Fetch trends or subreddits: curl "https://reddapi.dev/api/v1/trends" -H "Authorization: Bearer $REDDAPI_API_KEY"
Best Practices
- Use precise, intent-driven semantic queries to surface actionable insights
- Combine semantic results with Trends API data to validate opportunities
- Cache and batch requests to reduce latency during large research sessions
- Securely store and rotate your API key (REDDAPI_API_KEY) and monitor usage
- Regularly refresh data to track shifts in sentiment and topic momentum
Example Use Cases
- Market Research: Analyze competitor problems and complaints using a semantic search query like 'COMPETITOR problems complaints' with limit 200
- Niche Discovery: Find underserved user needs with a query such as 'I wish there was an app that' and limit 100
- Trend Analysis: Retrieve /api/v1/trends and parse growth_rate to identify rising topics
- Subreddit Discovery: List popular subreddits with /api/subreddits?limit=100 and inspect engagement
- Content Research: Pull sample posts (id, title, selftext, subreddit, score, comments) to gauge sentiment and themes