Files
RSSHub/docs/en/parameter.md
Rongrong d676247f05 docs(parameter): URL encode warning (#9678)
Signed-off-by: Rongrong <i@rong.moe>
2022-05-03 03:34:13 +08:00

3.9 KiB
Raw Blame History

Parameters

::: tip

The parameters can be linked with & to used together to generate a complex feed.

:::

Filtering

::: warning Warning

Please make sure you've fully URL-encoded the parameters. Do not rely on the browser's automatic URL encoding. Some characters, such as +, &, will not be automatically encoded, resulting in the final parsing result not being correct.

:::

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

  • filter_author: filter author only

  • filter_time: filter pubDate, in seconds, return specified time range. Item without pubDate will not be filtered.

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

  • filterout_author: filter author only

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

Set filter_case_sensitive to determine whether the filtering keywords should be case sensitive. The parameter would apply to both filter and filterout.

Default: true

Example: https://rsshub.app/dribbble/popular?filter=BluE|yeLLow|BlaCK&filter_case_sensitive=false

Limit Entries

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

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

Fulltext

Enable fulltext via mode parameter.

E.g. Bilibili article https://rsshub.app/bilibili/user/article/334958638?mode=fulltext

Access Control

Set key or code to grant access to requests. See Access Control Configuration.

Telegram Instant View

Replace website link with Telegram's Instant View link.

Enable Telegram Instant View requires a page template, it can be obtained from Telegram's Instant View page

  • tgiv: template hash, obtained from the link of template page generatedthe string after &rhash=

E.g. https://rsshub.app/novel/biquge/94_94525?tgiv=bd3c42818a7f7e

Output Sci-hub link in scientific journal routes, this supports major journals or routes that output DOIs.

  • scihub: set to any value

E.g. https://rsshub.app/pnas/latest?scihub=1

Conversion between Traditional and Simplified Chinese

  • opencc: s2t (Simplified Chinese to Traditional Chinese)、t2s (Traditional Chinese to Simplified Chinese), other optional values refer to simplecc-wasm - Configurations

E.g. https://rsshub.app/dcard/posts/popular?opencc=t2s

Output Formats

RSSHub conforms to RSS 2.0 and Atom Standard, simply append .rss .atom to the end of the feed address to obtain the feed in corresponding format. The default output format is RSS 2.0.

For example: