reddapi
Scanned@dowands
npx machina-cli add skill @dowands/reddapi --openclawreddapi.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 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
Overview
reddapi.dev lets you access Reddit's complete data archive through its API. It offers semantic search across posts and comments, subreddit discovery, and real-time trend analysis. This makes it valuable for market research, competitive intelligence, and niche opportunity discovery.
How This Skill Works
Authenticate with an API key (REDDAPI_API_KEY) and call endpoints like /api/v1/search/semantic, /api/v1/trends, and /api/subreddits. Responses are JSON with search results, trend metrics, and subreddit data. Use curl examples in the docs to integrate into workflows.
When to Use It
- Competitive analysis of competitor discussions to identify pain points and product gaps
- Market research to gauge interest and sentiment around product concepts
- Niche discovery by surfacing underserved user needs and requests
- Real-time trend monitoring to track emerging topics and momentum
- Subreddit discovery to locate communities aligned with a target market
Quick Start
- Step 1: Get an API key and export it (export REDDAPI_API_KEY="your_api_key")
- Step 2: Perform a semantic search (e.g., curl -X POST 'https://reddapi.dev/api/v1/search/semantic' -H 'Authorization: Bearer $REDDAPI_API_KEY' -d '{"query": "your query", "limit": 100}')
- Step 3: Retrieve trends and subreddit data (curl 'https://reddapi.dev/api/v1/trends' -H 'Authorization: Bearer $REDDAPI_API_KEY', curl 'https://reddapi.dev/api/subreddits?limit=100' -H 'Authorization: Bearer $REDDAPI_API_KEY')
Best Practices
- Securely store and reference your API key; set REDDAPI_API_KEY in your environment
- Leverage semantic search to surface explicit user pain points and needs
- Use the limit parameter to control result size and manage costs
- Cross-reference trends data with semantic results to prioritize opportunities
- Respect API rate limits and cache frequent queries for efficiency
Example Use Cases
- Analyze competitor discussions to surface problems and complaints
- Find underserved user needs with prompts like 'I wish there was an app that'
- Monitor topic growth and engagement using the Trends API
- Identify popular subreddits in a niche, e.g., programming or design
- Combine semantic insights with trend data to prioritize feature ideas