RSSHub/docs/en/social-media.md

26 KiB

pageClass
routes

Social Media

CuriousCat

User

Dev.to

Top Posts

dev.to weekly top dev.to monthly top dev.to yearly top dev.to top posts of all time
week month year infinity

Disqus

Comment

Facebook

Page

Fur Affinity

Home

Type

artwork crafts music writing
artwork crafts music writing

Browse

Website Status

Userpage Profile

User's Watching List

User's Watcher List

User's Commission Information

User's Shouts

User's Journals

User's Scraps

User's Favorites

Submission Comments

Journal Comments

Gab

User's Posts

Instagram

::: warning

Due to Instagram API restrictions, you have to setup your credentials on the server. See deployment guide for more.

If you don't want to setup credentials, use Picuki.

:::

User Profile

Lofter

User

Tag

new date week month total
最新 日榜 周榜 月榜 总榜

Mastodon

::: tip

Official user RSS:

  • RSS: https://**:instance**/users/**:username**.rss (Example)
  • Atom: https://**:instance**/users/**:username**.atom (Only for pawoo.net, example)

These feed do not include boosts (a.k.a. reblogs). RSSHub provides a feed for user timeline based on the Mastodon API, but to use that, you will need to create application on a Mastodon instance, and configure your RSSHub instance. Check the Deploy Guide for route-specific configurations.

:::

User timeline

Instance timeline (local)

Instance timeline (federated)

User timeline (backup)

piapro

User latest works

Website latest works

Picuki

User Profile

functionalFlag Video embedding Fetching Instagram Stories
0 off, only show video poster as an image off
1 (default) on off
10 on on

::: warning

Instagram Stories do not have a reliable guid. It is possible that your RSS reader show the same story more than once. Though, every Story expires after 24 hours, so it may be not so serious.

:::

pixiv

User Bookmark

User Activity

Rankings

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

Keyword

only not R18 only R18 no filter
safe r18 empty or other

Following timeline

::: warning

Only for self-hosted

:::

pixiv-fanbox

Telegram

Channel

Key Description Accepts Defaults to
showLinkPreview Show the link preview from Telegram 0/1/true/false true
showViaBot For messages sent via bot, show the bot 0/1/true/false true
showReplyTo For reply messages, show the target of the reply 0/1/true/false true
showFwdFrom For forwarded messages, show the forwarding source 0/1/true/false true
showFwdFromAuthor For forwarded messages, show the author of the forwarding source 0/1/true/false true
showInlineButtons Show inline buttons 0/1/true/false false
showMediaTagInTitle Show media tags in the title 0/1/true/false true
showMediaTagAsEmoji Show media tags as emoji 0/1/true/false true
includeFwd Include forwarded messages 0/1/true/false true
includeReply Include reply messages 0/1/true/false true
includeServiceMsg Include service messages (e.g. message pinned, channel photo updated) 0/1/true/false true
includeUnsupportedMsg Include messages unsupported by t.me 0/1/true/false false
searchQuery search query keywords; replace # by %23 for hashtag searching (search disabled)

Specify different option values than default values can meet different needs, URL

https://rsshub.app/telegram/channel/NewlearnerChannel/showLinkPreview=0&showViaBot=0&showReplyTo=0&showFwdFrom=0&showFwdFromAuthor=0&showInlineButtons=0&showMediaTagInTitle=1&showMediaTagAsEmoji=1&includeFwd=0&includeReply=1&includeServiceMsg=0&includeUnsupportedMsg=0

generates an RSS without any link previews and annoying metadata, with emoji media tags in the title, without forwarded messages (but with reply messages), and without messages you don't care about (service messages and unsupported messages), for people who prefer pure subscriptions.

::: tip

For backward compatibility reasons, invalid routeParams will be treated as searchQuery .

Due to Telegram restrictions, some channels involving pornography, copyright, and politics cannot be subscribed. You can confirm by visiting https://t.me/s/:username.

:::

Sticker Pack

Telegram Blog

Twitter

::: warning

Due to restrictions from Twitter, currently only tweets within 7 days are available in some routes.

Some routes rely on the Twitter Developer API, which requires to be specially configured to enable.
There are two routes (/twitter/user and /twitter/keyword) comes with Web API implementation which does not require to be specially configured to enable along with the Developer API implementation. By default, the Developer API is prioritized, but if it is not configured or errors, the Web API will be used. However, there are some differences between the two APIs, e.g. excludeReplies in the Developer API will treat threads (self-replied tweets) as replies and exclude them, while in the Web API it will not. If you would like to exclude replies but include threads, enable forceWebApi in the /twitter/user route.

:::

Specify options (in the format of query string) in parameter routeParams to control some extra features for Tweets

Key Description Accepts Defaults to
readable Enable readable layout 0/1/true/false false
authorNameBold Display author name in bold 0/1/true/false false
showAuthorInTitle Show author name in title 0/1/true/false false (true in /twitter/followings)
showAuthorInDesc Show author name in description (RSS body) 0/1/true/false false (true in /twitter/followings)
showQuotedAuthorAvatarInDesc Show avatar of quoted Tweet's author in description (RSS body) (Not recommended if your RSS reader extracts images from description) 0/1/true/false false
showAuthorAvatarInDesc Show avatar of author in description (RSS body) (Not recommended if your RSS reader extracts images from description) 0/1/true/false false
showEmojiForRetweetAndReply Use "🔁" instead of "Rt", "↩️" & "💬" instead of "Re" 0/1/true/false false
showRetweetTextInTitle Show quote comments in title (if false, only the retweeted tweet will be shown in the title) 0/1/true/false true
addLinkForPics Add clickable links for Tweet pictures 0/1/true/false false
showTimestampInDescription Show timestamp in description 0/1/true/false false
showQuotedInTitle Show quoted tweet in title 0/1/true/false false
widthOfPics Width of Tweet pictures Unspecified/Integer Unspecified
heightOfPics Height of Tweet pictures Unspecified/Integer Unspecified
sizeOfAuthorAvatar Size of author's avatar Integer 48
sizeOfQuotedAuthorAvatar Size of quoted tweet's author's avatar Integer 24
excludeReplies Exclude replies, only available in /twitter/user 0/1/true/false false
includeRts Include retweets, only available in /twitter/user 0/1/true/false true
forceWebApi Force using Web API even if Developer API is configured, only available in /twitter/user and /twitter/keyword 0/1/true/false false
count count parameter passed to Twitter API, only available in /twitter/user Unspecified/Integer Unspecified

Specify different option values than default values to improve readability. The URL

https://rsshub.app/twitter/user/durov/readable=1&authorNameBold=1&showAuthorInTitle=1&showAuthorInDesc=1&showQuotedAuthorAvatarInDesc=1&showAuthorAvatarInDesc=1&showEmojiForRetweetAndReply=1&showRetweetTextInTitle=0&addLinkForPics=1&showTimestampInDescription=1&showQuotedInTitle=1&heightOfPics=150

generates

Readable Twitter RSS of Durov

User timeline

User media

User following timeline

::: warning

This route requires Twitter token's corresponding id, therefore it's only available when self-hosting, refer to the Deploy Guide for route-specific configurations.

:::

List timeline

User likes

Keyword

Vimeo

User Profile

::: tip Special category name attention

Some of the categories contain slash like 3D/CG , must change the slash / to the vertical bar|.

:::

Channel

Category

YouTube

::: tip Tiny Tiny RSS users please notice

Tiny Tiny RSS will add sandbox="allow-scripts" to all iframe elements, as a result, YouTube embedded videos cannot be loaded. If you need to use embedded videos, please install plugin remove_iframe_sandbox for Tiny Tiny RSS.

:::

User

Channel

::: tip

YouTube provides official RSS feeds for channels, for instance https://www.youtube.com/feeds/videos.xml?channel_id=UCDwDMPOZfxVV0x_dz0eQ8KQ.

:::

Playlist