# reddapi.dev Reddit Search API API

> reddapi.dev Reddit Search API is an AI-powered Reddit search engine that crawls millions of Reddit posts daily and provides semantic search capabilities.

## API Base URL

https://reddapi.dev/api/v1

## Authentication

All API requests require authentication via Bearer token:

```
Authorization: Bearer YOUR_API_KEY
```

API keys are available in your account dashboard after subscribing to a paid plan.

## Endpoints

### POST /api/v1/search/semantic

Semantic Search (AI Search) - Search Reddit conversations using natural language queries with AI-powered semantic understanding.

**Request Body:**
- `query` (string, required): Natural language search query
- `limit` (number, optional): Maximum results to return (default: 20)

**Response Fields:**
- `results[].id`: Post ID
- `results[].title`: Post title
- `results[].content`: Post content
- `results[].subreddit`: Subreddit name
- `results[].upvotes`: Number of upvotes
- `results[].comments`: Number of comments
- `results[].created`: ISO timestamp
- `results[].relevance`: Relevance score (0-1)
- `results[].sentiment`: Sentiment analysis (positive/negative/neutral)
- `results[].url`: Reddit URL
- `ai_summary`: AI-generated summary of results

### POST /api/v1/search/vector

Vector Search - High-speed vector similarity search on Reddit posts.

**Request Body:**
- `query` (string, required): Search query
- `limit` (number, optional): Maximum results (default: 30)
- `start_date` (string, optional): Filter start date (YYYY-MM-DD)
- `end_date` (string, optional): Filter end date (YYYY-MM-DD)

**Response Fields:**
- `results[].id`: Post ID
- `results[].title`: Post title
- `results[].content`: Post content
- `results[].subreddit`: Subreddit name
- `results[].upvotes`: Number of upvotes
- `results[].comments`: Number of comments
- `results[].created`: ISO timestamp
- `results[].similarity_score`: Similarity score (0-1)
- `results[].url`: Reddit URL

### POST /api/v1/trends

Trending Topics - Discover trending topics and discussions on Reddit.

**Request Body:**
- `start_date` (string, required): Start date (YYYY-MM-DD)
- `end_date` (string, required): End date (YYYY-MM-DD)
- `limit` (number, optional): Maximum trends to return (default: 20)

**Response Fields:**
- `trends[].id`: Trend ID
- `trends[].topic`: Topic name
- `trends[].post_count`: Number of posts
- `trends[].total_upvotes`: Total upvotes
- `trends[].total_comments`: Total comments
- `trends[].avg_sentiment`: Average sentiment score
- `trends[].top_subreddits`: Array of top subreddits
- `trends[].trending_keywords`: Array of keywords
- `trends[].trend_score`: Trend score
- `trends[].growth_rate`: Growth rate percentage

## Rate Limits

| Plan | Monthly Quota | Rate Limit |
|------|---------------|------------|
| Free | N/A | API not available |
| Lite | 500 requests/month | 50 requests/minute |
| Starter | 5,000 requests/month | 50 requests/minute |
| Pro | 15,000 requests/month | 20 requests/minute |
| Enterprise | Unlimited | Custom limits |

## Response Headers

All paid API responses include:
- `X-RateLimit-Limit`: Your rate limit
- `X-RateLimit-Remaining`: Remaining requests
- `X-RateLimit-Reset`: Reset timestamp

## Error Codes

- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Subscription required or quota exceeded
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error

## Links

- Documentation: https://reddapi.dev/developers
- Pricing: https://reddapi.dev/pricing
- Account Dashboard: https://reddapi.dev/account