RSSHub/docs/en/social-media.md

38 KiB

pageClass
routes

Social Media

Crossbell

Notes

Notes of character

Notes of source

Feeds of following

CuriousCat

User

Curius

User

Daily.dev

Most Discussed

Most upvoted

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

Discord

Channel Messages

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

GETTR

User timeline

Instagram

::: warning

Due to Instagram Private API restrictions, you have to setup your credentials on the server. 2FA is not supported. See deployment guide for more.

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

:::

User Profile / Hashtag - Private API

User timeline Hashtag
user tags

::: tip Tips It's highly recommended to deploy with Redis cache enabled. :::

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 may need to create application on a Mastodon instance, and configure your RSSHub instance. Check the Deploy Guide for route-specific configurations.

:::

User timeline

Started from Mastodon v4.0.0, the use of the search API in the route no longer requires a user token. If the domain of your Webfinger account URI is the same as the API host of the instance (i.e., no delegation called in some other protocols), then no configuration is required and the route is available out of the box. However, you can still specify these route-specific configurations if you need to override them.

Instance timeline (local)

If the instance address is not mastodon.social or pawoo.net, then the route requires ALLOW_USER_SUPPLY_UNSAFE_DOMAIN to be true.

Instance timeline (federated)

If the instance address is not mastodon.social or pawoo.net, then the route requires ALLOW_USER_SUPPLY_UNSAFE_DOMAIN to be true.

User timeline (backup)

If the instance address is not mastodon.social or pawoo.net, then the route requires ALLOW_USER_SUPPLY_UNSAFE_DOMAIN to be true.

Misskey

piapro

User latest works

Website latest works

Picnob

User Profile

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

User Novels

Rankings

daily rank weekly rank monthly rank male rank female rank AI-generated work Rankings original rank rookie user rank
day week month day_male day_female day_ai week_original week_rookie
R-18 daily rank R-18 AI-generated work R-18 male rank R-18 female rank R-18 weekly rank R-18G rank
day_r18 day_r18_ai 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

:::

pixivFANBOX

User

Plurk

Topic

Top

Top Replurks Top Favorites Top Responded
topReplurks topFavorites topResponded
English 中文(繁體)
en zh

Anonymous

Search

Plurk News

User

Rattibha

User Threads

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

Threads

User timeline

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

Key Description Accepts Defaults to
showAuthorInTitle Show author name in title 0/1/true/false true
showAuthorInDesc Show author name in description (RSS body) 0/1/true/false true
showQuotedAuthorAvatarInDesc Show avatar of quoted 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 falseP
showEmojiForQuotesAndReply Use "🔁" instead of "QT", "↩️" instead of "Re" 0/1/true/false true
showQuotedInTitle Show quoted tweet in title 0/1/true/false true
replies Show replies 0/1/true/false true

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

https://rsshub.app/threads/zuck/showAuthorInTitle=1&showAuthorInDesc=1&showQuotedAuthorAvatarInDesc=1&showAuthorAvatarInDesc=1&showEmojiForQuotesAndReply=1&showQuotedInTitle=1

TikTok

User

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
showSymbolForRetweetAndReply Use " RT " instead of "", " Re " instead of "" 0/1/true/false true
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

Collection

::: 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.

:::

Tweet Details

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.

:::

Custom URL

Playlist

Community

Subscriptions

Music Charts

::: details Chart

Top artists Top songs Top music videos Trending
TopArtists TopSongs TopVideos TrendingVideos
:::

::: details Country Code

Argentina Australia Austria Belgium Bolivia Brazil Canada
ar au at be bo br ca
Chile Colombia Costa Rica Czechia Denmark Dominican Republic Ecuador
cl co cr cz dk do ec
Egypt El Salvador Estonia Finland France Germany Guatemala
eg sv ee fi fr de gt
Honduras Hungary Iceland India Indonesia Ireland Israel Italy
hn hu is in id ie il it
Japan Kenya Luxembourg Mexico Netherlands New Zealand Nicaragua
jp ke lu mx nl nz ni
Nigeria Norway Panama Paraguay Peru Poland Portugal Romania
ng no pa py pe pl pt ro
Russia Saudi Arabia Serbia South Africa South Korea Spain Sweden Switzerland
ru sa rs za kr es se ch
Tanzania Turkey Uganda Ukraine United Arab Emirates United Kingdom United States
tz tr ug ua ae gb us
Uruguay Zimbabwe
uy zw

:::