opensource/RSSHub
1
0
Fork 0
mirror of https://github.com/DIYgod/RSSHub.git synced 2025-12-08 05:59:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
8d1a071ab343d5ea2e8a499f3e99ee5724e64d45
RSSHub/docs/en
History

README.md

sidebar
sidebar
auto

RSSHub

RSSHub

🍰 Everything is RSSible

RSSHub is a lightweight and extensible RSS feed aggregator, it's able to generate feeds from pretty much everything.

Special Thanks

Special Sponsors

Sponsors

Contributors

::: tip

Free feel to test the demo instance, the cache expiry time is set to 10 minutes.

:::

Parameters

::: tip

All parameters can be used together to generate a complex feed

:::

Filtering

The following URL query parameters are supported, Regex support is built-in

Set filter to include the content

  • filter: filter title and description

  • filter_title: filter title only

  • filter_description: filter description only

For example: https://rsshub.app/dribbble/popular?filter=Blue|Yellow|Black

Set filterout to exclude unwanted content

  • filterout: filter title and description

  • filterout_title: filter title only

  • filterout_description: filter description only

For example: https://rsshub.app/dribbble/popular?filterout=Blue|Yellow|Black

Limit Entries

Set limit to limit the number of articles in the feed,

Eg: Dribbble Popular Top 10 https://rsshub.app/dribbble/popular?limit=10

Output Formats

RSSHub supports RSS 2.0、Atom and JSON Feed as the output formats, simply append .rss .atom or .json to the end of the feed address, default to RSS 2.0

For exmaple:

Application Updates

RSSHub

Eg: https://rsshub.app/rsshub/rss

Route: /rsshub/rss

Parameters: N/A

MIUI

Eg: https://rsshub.app/miui/aries/

Route: /miui/:device/:type?

Parameters:

device: the device codename eg. aries for Mi 2S

type: type, optional

stable development
release dev

Firefox New Release

Eg: https://rsshub.app/firefox/release/desktop

Route: /firefox/release/:platform

Parameters:

  • platform
Desktop Android Beta Nightly Android Beta
desktop android beta nightly android-beta

App Store/Mac App Store Updates

Eg: https://rsshub.app/appstore/update/us/id697846300

Route: /appstore/update/:country/:id

Parameters：

country, App Store Country, obtain from the app URL https://itunes.apple.com/us/app/reeder-3/id697846300?mt=8, in this case, us.

id, App Store app id, obtain from the app URL https://itunes.apple.com/us/app/reeder-3/id697846300?mt=8, in this case, id697846300.

App Store/Mac App Store Price Drop Alert

Eg: https://rsshub.app/appstore/price/us/mac/id1152443474

Route: /appstore/price/:country/:type/:id

Parameters：

App Store/Mac App Store In-App-Purchase Price Drop Alert

Eg: https://rsshub.app/appstore/iap/us/id953286746

Route: /appstore/iap/:country/:id

Parameters:

pixiv

User Bookmark

Eg: https://rsshub.app/pixiv/user/bookmarks/15288095

Route: /pixiv/user/bookmarks/:id

Parameters:

  • id, user id, available in user's homepage URL

User Activity

Eg: https://rsshub.app/pixiv/user/11

Route: /pixiv/user/:id

Parameters:

  • id, user id, available in user's homepage URL

Rankings

Eg: https://rsshub.app/pixiv/ranking/week

Route: /pixiv/ranking/:mode/:date?

Parameters

  • mode: rank type

    pixiv daily rank pixiv weekly rank pixiv monthly rank pixiv male rank pixiv female rank pixiv original rank pixiv rookie user rank
    day week month day_male day_female week_original week_rookie
    pixiv R-18 daily rank pixiv R-18 male rank pixiv R-18 female rank pixiv R-18 weekly rank pixiv R-18G rank
    day_r18 day_male_r18 day_female_r18 week_r18 week_r18g

  • date: date, format: 2018-4-25

Disqus

Comment

Eg: https://rsshub.app/disqus/posts/diygod-me

Route: /disqus/posts/:forum

Parameters:

  • forum, disqus name of the target website

Twitter

User

Eg: https://rsshub.app/twitter/user/DIYgod

Route: /twitter/user/:id

Parameters:

  • id, twitter handler

Instagram

User

Eg: https://rsshub.app/instagram/user/diygod

Route: /instagram/user/:id

Parameters:

  • id, Instagram id

Youtube

User

Eg: https://rsshub.app/youtube/user/JFlaMusic

Route: /youtube/user/:username

Parameters:

  • username, Youtuber's username

Channel

Eg: https://rsshub.app/youtube/channel/UCDwDMPOZfxVV0x_dz0eQ8KQ

Route: /youtube/channel/:id

Parameters:

  • id, channel id

Dribbble

Popular

Eg:

https://rsshub.app/dribbble/popular

https://rsshub.app/dribbble/popular/week

Route: /dribbble/popular/:timeframe?

Parameters:

  • timeframe, optional, support the following values: week, month, year and ever

User (or team)

Eg: https://rsshub.app/dribbble/user/google

Route: /dribbble/user/:name

Parameters:

  • name, username, available in user's homepage URL

Keyword

Eg: https://rsshub.app/dribbble/keyword/player

Route: /dribbble/keyword/:keyword

Parameters:

  • keyword, the desired keyword

Telegram

Channel

::: tip

Bot initialization required: Add Telegram Bot @RSSHub_bot as an admin to the channel and send at least one message in the channel for the bot to obtain the chat_id.

:::

Eg: https://rsshub.app/telegram/channel/awesomeDIYgod

Route: /telegram/channel/:username

Parameters:

  • username, channel name

GitHub

::: tip

GitHub provides some official RSS feeds:

:::

User Repo

Eg: https://rsshub.app/github/repos/DIYgod

Route: /github/repos/:user

Parameters:

  • user, username

Trending

Eg:

https://rsshub.app/github/trending/daily

https://rsshub.app/github/trending/daily/javascript

Route: /github/trending/:since/:language?

Parameters:

  • since, time frame, available in Trending page 's URL, possible values are: daily, weekly or monthly

  • language, the feed language, available in Trending page 's URL

Issue

Eg: https://rsshub.app/github/issue/DIYgod/RSSHub

Route: /github/issue/:user/:repo

Parameters:

  • user, username

  • repo, repo name

Follower

Eg: https://rsshub.app/github/user/followers/HenryQW

Route: /github/user/follower/:user

Parameters:

  • user, username

Star

Eg: https://rsshub.app/github/stars/DIYGod/RSSHub

Route: /github/stars/:user/:repo

Parameters:

  • user, username

  • repo, repo name

EZTV

::: tip

EZTV provides an official RSS feed of all torrents: https://eztv.ag/ezrss.xml

:::

Torrent Lookup by IMDB ID

Eg: https://rsshub.app/eztv/torrents/6048596

Route: /eztv/torrents/:imdb_id

Parameters:

  • imdb_id, search for the IMDB ID of the desired show, available at IMDB

Hexo Blog

Blog using Next theme

Eg: http://rsshub.app/hexo/next/fengkx.top

Route: /hexo/next/:url

Parameters:

  • url, the blog URL without the protocol (http:// and https://)

Greasy Fork

Script Update

Eg: https://rsshub.app/greasyfork/en/google.com

Route: /greasyfork/:language/:domain?

Parameters:

  • language, language, located on the top right corner of Greasy Fork's search page, set to all for including all languages

  • domain, the script's target domain, optional

All the Flight Deals

Flight Deals

Eg: https://rsshub.app/atfd/us+new york,gb+london/1

Route: /atfd/:locations/:nearby?

Parameters:

For ISO 3166-1 country codes please refer to Wikipedia ISO_3166-1

  • nearby: whether includes nearby airports, optional value of 0 or 1, default to 0 (exclude nearby airports)

::: tip

If the city name contains a space like Mexico City, replace the space with %20, Mexico%20City.

:::

Google

Google Scholar Keywords Monitoring

::: warning

Google Scholar has strict anti-crawling mechanism implemented, the demo below doesn't guarantee availability. Please deploy your own instance as it might increase the stability.

:::

Eg: https://rsshub.app/google/scholar/data+visualization

Route: /google/scholar/:query

Parameters:

Hopper

Hopper Flight Deals

This route returns a list of flight deals (in most cases, 6 flight deals) for a period defined by Hopper's algorithm, which means the travel date will be totally random (could be tomorrow or 10 months from now).

Eg: London Heathrow Airport ✈ Beijing Capital International Airport https://rsshub.app/hopper/1/LHR/PEK

Route: /hopper/:lowestOnly/:from/:to?

Parameters:

  • lowestOnly, set to 1 will return the cheapest deal only, instead of all deals, so you don't get spammed

  • from, origin airport IATA code

  • to, destination airport IATA code, optional, if unset the destination will be set to anywhere

For airport IATA code please refer to Wikipedia List of airports by IATA code

Reference in New Issue View Git Blame Copy Permalink