Using Feeddit

Table of Contents

• Getting Started
• Feed URLs
• Recovering Your ID
• Deleting Your Information
• Tips
• Troubleshooting

Getting Started

To use Feeddit, you'll need Reddit API credentials from a Reddit account.

0. Use a burner account!

I recommend using a burner account for your Reddit API credentials. You shouldn't give your real account's keys to strangers, nor should you use them to do things reddit maybe doesn't like.

Since this runs from our servers, the key usage is not necessarily tied to your device or IP address *at the time of use*. Reddit may be able to still associate the key usage if you signed up for and/or created the app on the same device or IP address - I can't guarantee any of this.

1. Get Reddit API Credentials

1. Go to Reddit's App Preferences
2. Click "Create Another App..." at the bottom
3. Select "script" as the app type
4. Fill in any name and "http://localhost" as the redirect URI
5. Click "Create app"
6. Note down your:
   • Client ID (appears under your app name)
   • Client Secret (labeled as "secret")

2. Generate Your Feed ID

1. Go to the Add Key page
2. Enter your Client ID and Client Secret
3. Submit the form to receive your unique feed ID
4. Save this ID - you'll need it to access your feeds

3. Add your feeds to your RSS Reader

1. Go to your feed reader of choice
2. Start adding feeds for your favourite subreddits - see below for options

Feed URLs

Once you have your ID, you can access any subreddit's feed using these URL patterns:

Available Endpoints

Recovering Your ID

If you lose your feed ID but still have your Reddit API credentials, you can recover it simply by going to the Add Key page and submitting the form again. You'll receive your existing feed ID back.

Deleting Your Information

If you wish to delete all your details (key, ID etc) from our database, please go to the Delete Key page. This will remove all your information from our database and you will no longer be able to access your feeds.

Tips

• Use a burner Reddit account for your API credentials
• Each feed URL returns up to 25 of the "hottest" posts
• Feeds are cached for 5 minutes to respect Reddit's rate limits
• Your feed reader if responsible for handling duplicate posts

Troubleshooting

Feed Returns 404

The subreddit doesn't exist or is private

Feed Returns 403

Using the SFW endpoint on an NSFW subreddit

Feed Returns 500

Reddit API error or rate limit exceeded - try again in a few minutes

ID Not Found

Double-check your ID or regenerate it using your API credentials