This project is a Deno-based server application serving as an API for fetching Reddit posts from RSS feeds. It offers multiple endpoints to retrieve posts from one or more subreddits.
The merge option enables you to gather data from multiple RSS feeds and consolidate them into a single response. By default, Reddit's RSS feed can return data from multiple subreddits in one request, but it has limitations on the amount of data. Setting the merge option to true prompts our API to send separate requests for each specified subreddit and then merge the results. This method yields more items compared to Reddit's default multiple subreddit RSS feed.
- Initiate API usage by sending requests to https://reddit-rss-api.deno.dev/r/{subreddits}.
- You can specify multiple subreddit names by separating them with a
+.
When using the API, you can combine different query parameters to tailor your request according to your needs.
- option: Set this query parameter to
randomto fetch a random post from the specified subreddit(s). - sort: Set this query parameter to
mixed,asc, ordescto sort the posts. - filter: Set this query parameter to
image,videoorvideo+imageto retrieve only filtered posts from the feeds. - merge: Set this query parameter to
trueorfalseto merge items from multiple subreddits, useful for obtaining more posts from the feeds. - count: Set this query parameter for limit items. (count={number})
type ResponseData = {
feed?: Feed;
title: string;
lastBuildDate: Date;
link: string;
feedUrl: string;
itemsLength?: number;
items: ExtractedItem[];
};
type ExtractedItem = {
title: string;
link: string;
author: string;
isoDate: Date;
feedURL: string;
id: string;
message?: string;
links?: string[];
images?: string[];
videos?: string[];
};
type Feed = {
title: string;
lastBuildDate: Date;
link: string;
feedUrl: string;
items: FeedItem[];
};
type FeedItem = {
id: string;
title: string;
link: string;
pubDate: Date;
author: string;
content: string;
contentSnippet: string;
isoDate: Date;
};
