Get the FREE Ultimate OpenClaw Setup Guide →

reddit-search-api

Scanned
npx machina-cli add skill lignertys/reddit-research-skills/reddit-search-api --openclaw
Files (1)
SKILL.md
3.8 KB

reddit-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 posts
  • total_upvotes: Engagement score
  • avg_sentiment: Sentiment analysis (-1 to 1)
  • trending_keywords: Top keywords
  • growth_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

  1. Step 1: Export your API key: export REDDAPI_API_KEY="your_api_key"
  2. 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}'
  3. 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

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers