Skip to main content

Getting Started

Generate an RSS Feed​

To subscribe to a Twitter user's timeline, first look at the route document of Twitter User Timeline.

/twitter/user/:id is the route where :id is the actual Twitter username you need to replace. For instance, /twitter/user/DIYgod with a prefix domain name will give you the timeline of Twitter user DIYgod.

The demo instance will generate an RSS feed at https://rsshub.app/twitter/user/DIYgod, use your own domain name when applicable. This feed should work with all RSS readers conforming to the RSS Standard.

You can replace the domain name https://rsshub.app with your self-hosted instance or any public instance.

RSSHub supports additional parameters such as content filtering and full-text extraction, refer to Parameters for details.

Contribute a New Route​

Our thriving community is the key to RSSHub's success, we invite everyone to join us and contribute new routes for all kinds of interesting sources.

Use as a npm Package​

Apart from serving as an information source hub, RSSHub is also made compatible with all Node.js projects as an npm Package.

Install​

pnpm add rsshub

Usage​

const RSSHub = require('rsshub');

RSSHub.init({
    // config
});

RSSHub.request('/youtube/user/JFlaMusic')
    .then((data) => {
        console.log(data);
    })
    .catch((e) => {
        console.log(e);
    });

For supported configs please refer to the Configuration Section.

A short example for disabling caching can be written as:

{
    CACHE_TYPE: null,
}

Radar​

In addition to the two functions of generating RSS and obtaining data, RSSHub also provides a Radar function, which is used to map website addresses to RSSHub addresses.

Configuration file​

Radar has two types of configuration files, one is a full-featured js file, and the other is a simplified json file.

Usage​

You need to use supported browser extensions, mobile apps, RSS readers, or other tools to use the Radar feature. Please refer to the documentation of the corresponding tool for specific usage instructions.