reddapi
Scannednpx machina-cli add skill lignertys/reddit-research-skills/reddapi --openclawFiles (1)
SKILL.md
3.7 KB
reddapi.dev 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
- niche-hunter: Automated opportunity discovery
- market-analysis: Comprehensive research workflows
Source
git clone https://github.com/lignertys/reddit-research-skills/blob/main/skills/reddapi/SKILL.mdView on GitHub Overview
reddapi.dev provides access to Reddit's complete data archive through a powerful API. It offers semantic search across posts and comments, a subreddit discovery endpoint, and real-time trend analysis, making it ideal for market research, competitive analysis, and niche discovery.
How This Skill Works
The skill authenticates to reddapi.dev with a Bearer API key. You can perform semantic search at /api/v1/search/semantic, fetch trends at /api/v1/trends, and discover subreddits via /api/subreddits. Responses return structured fields like id, title, selftext, subreddit, score, num_comments, and created_utc for each item.
When to Use It
- Market Research: Analyze competitor discussions to surface pain points and product gaps.
- Niche Discovery: Identify underserved user needs and conversation themes.
- Trend Analysis: Monitor topic growth and sentiment over time.
- Subreddit Discovery: Find relevant communities to target outreach and campaigns.
- Content Ideation: Generate ideas by extracting high-value topics and questions from Reddit threads.
Quick Start
- Step 1: Get your API key from reddapi.dev and set REDDAPI_API_KEY in your environment.
- Step 2: Run a semantic search query, e.g. curl -X POST "https://reddapi.dev/api/v1/search/semantic" -H "Authorization: Bearer $REDDAPI_API_KEY" -d '{"query": "your question", "limit": 100}'
- Step 3: Fetch trends or subreddits to enrich insights, e.g. curl "https://reddapi.dev/api/v1/trends" -H "Authorization: Bearer $REDDAPI_API_KEY" and curl "https://reddapi.dev/api/subreddits?limit=100" -H "Authorization: Bearer $REDDAPI_API_KEY"
Best Practices
- Securely store and rotate your REDDAPI_API_KEY; use environment variables.
- Start with semantic search prompts that reflect real customer pains to surface actionable insights.
- Combine semantic results with trends data to validate momentum before prioritizing opportunities.
- Paginate results with the limit parameter to control data volume and monitor usage.
- Cross-check reddapi results with primary Reddit data or other sources to ensure data quality.
Example Use Cases
- Market Research: Analyze competitor problems and complaints to identify product gaps.
- Niche Discovery: Find underserved needs like prompts starting with 'I wish there was an app that'.
- Trend Analysis: Track growth of topics such as AI regulation using the trends endpoint.
- Subreddit Discovery: Compile a list of popular subreddits for outreach in programming and tech.
- Content Ideation: Extract recurring questions to guide FAQs and content calendars.
Frequently Asked Questions
Add this skill to your agents
