Metadata-Version: 2.4
Name: sylvia-api
Version: 1.0.0
Summary: Reddit data API client — no OAuth, no rate limits. Subreddits, users, search, live comments.
License-Expression: MIT
Project-URL: Homepage, https://sylvia-api.com
Project-URL: Documentation, https://sylvia-api.com/docs
Project-URL: Repository, https://github.com/emraan-harshme/sylvia-sdk
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25

# Sylvia Reddit API

**The fastest way to access Reddit data at scale.** No OAuth. No rate limit headaches. No browser automation. Just an API key.

```bash
pip install sylvia-api
```

## Quickstart

```python
from sylvia import Sylvia

# Sign up at https://sylvia-api.com to get your key
sylvia = Sylvia(api_key="syl_...")

# Subreddit info
python_sub = sylvia.subreddit("python")
print(f"r/{python_sub['name']}: {python_sub['members']:,} members")

# Get top posts
for post in sylvia.subreddit_posts("programming", sort="hot", limit=5):
    print(f"🔥 {post['score']} — {post['title']}")

# User profile
spez = sylvia.user("spez")
print(f"u/spez: {spez['comment_karma']:,} comment karma")

# Global search (not available in Reddit's own API!)
results = sylvia.search("llama 4 model", limit=10)
for post in results:
    print(f"r/{post['subreddit']} — {post['title']}")

# Live comment firehose
for comment in sylvia.live_comments(limit=10):
    print(f"u/{comment['author']}: {comment['body'][:100]}")

# Thread with ALL nested comments expanded
thread = sylvia.thread("1tlh5aj")
```

## How It Works

Sylvia operates a fleet of real residential proxy engines that fetch Reddit data through actual browsers. This means:
- **No OAuth** needed — just an API key
- **480 req/min free** (with free tier API key)
- **Global search** across all of Reddit
- **Live comment firehose** in real-time
- **Automatic IP rotation** — Reddit never blocks you

## Pricing

| Tier | Rate Limit | Price |
|------|-----------|-------|
| Free | 8 req/s (480/min) | $0 |
| Strela | 20 req/s | $50/mo |
| Svetka | 40 req/s | $200/mo |
| Enterprise | 60+ req/s | Custom |

Per-request billing: **$0.0005/request** ($0.50 per 1,000 requests). Failed requests are not charged.

[Sign up free →](https://sylvia-api.com)

## Comparison

| | Sylvia | Reddit API | Bright Data | Apify |
|---|---|---|---|---|
| OAuth required | ❌ No | ✅ Yes | ❌ No | ❌ No |
| Global search | ✅ Yes | ❌ No | ❌ No | Limited |
| Live comments | ✅ Yes | ❌ No | ❌ No | ✅ Yes |
| Auto IP rotation | ✅ Yes | ❌ No | ✅ Yes | ✅ Yes |
| Free tier | 480 req/min | 60 req/min | None | 100 req/mo |
| Per-1K cost | $0.50 | Free (limited) | $8.40/GB | ~$5/1K |

## License

MIT
