Skip to content

README.md

Latest commit

 

History

History
98 lines (65 loc) · 1.71 KB

README.md

File metadata and controls

98 lines (65 loc) · 1.71 KB

Redditify Proxy Worker

A Cloudflare Worker that proxies Reddit JSON API requests, solving CORS and rate limiting issues.

Features

  • ✅ CORS headers for browser requests
  • ✅ Response caching (5 min TTL)
  • ✅ Automatic retries with backoff
  • ✅ Proper User-Agent headers
  • ✅ URL validation (only reddit.com)

Deployment

1. Install Wrangler

npm install -g wrangler

2. Login to Cloudflare

wrangler login

3. Deploy

cd worker
npm install
npm run deploy

Your worker will be available at: https://redditify-proxy.<your-subdomain>.workers.dev

Usage

Endpoint

GET /thread?url=<reddit_thread_url>

Example

curl "https://redditify-proxy.example.workers.dev/thread?url=https://www.reddit.com/r/PHP/comments/abc123/example"

Response

Returns the raw Reddit JSON data with CORS headers.

Configuration

Custom Domain

Edit wrangler.toml to add a custom domain:

routes = [
  { pattern = "reddit-proxy.yourdomain.com", custom_domain = true }
]

Cache TTL

Edit src/index.ts and change CACHE_TTL (in seconds):

const CACHE_TTL = 300; // 5 minutes

Rate Limits

Cloudflare Workers free tier: 100,000 requests/day

With caching, this handles significant traffic. For higher volume, upgrade to Workers Paid ($5/mo for 10M requests).

Using with Redditify

After deploying, update your Redditify usage:

<script>
  window.REDDITIFY_PROXY_URL = 'https://your-worker.workers.dev';
</script>
<script src="https://unpkg.com/redditify/dist/redditify.min.js"></script>

Or set to null to disable proxy (direct fetch, may hit CORS):

<script>
  window.REDDITIFY_PROXY_URL = null;
</script>