Add a feed or category

Add a category

Add a feed

Feed URL

Category

Type of feed source

XPath 1.0 is a standard query language for advanced users, and which FreshRSS supports to enable Web scraping.

XPath for:
feed title

Example: //title or a static string: "My custom feed"

XPath for:
finding news items
(most important)

Example: //div[@class="news-item"]

XPath (relative to item) for:
item title

Use in particular the XPath axis descendant:: like descendant::h2

XPath (relative to item) for:
item content

Example to take the full item: .

XPath (relative to item) for:
item link (URL)

Example: descendant::a/@href

XPath (relative to item) for:
item thumbnail

Example: descendant::img/@src

XPath (relative to item) for:
item author

Can also be a static string. Example: "Anonymous"

XPath (relative to item) for:
item date

The result will be parsed by strtotime()

Custom date/time format

Optional. A format supported by DateTime::createFromFormat() such as d-m-Y H:i:s

XPath (relative to item) for:
item tags

XPath (relative to item) for:
item unique ID

XPath for JSON in HTML

Example: normalize-space(//script[@type="application/json"]) (single JSON)
or: //script[@type="application/ld+json"] (one JSON object per article)

A JSON dot notated uses dots between objects and brackets for arrays (e.g. data.items[0].title)

dot notation for:
feed title

Example: meta.title or a static string: "My custom feed"

dot notation for:
finding news items
(most important)

JSON path to the array containing the items, e.g. $ or newsItems

dot notated path (relative to item) for:
item title

dot notated path (relative to item) for:
item content

Key under which the content is found, e.g. content

dot notated path (relative to item) for:
item link (URL)

Example: permalink

dot notated path (relative to item) for:
item thumbnail

Example: image

dot notated path (relative to item) for:
item author

dot notated path (relative to item) for:
item date

The result will be parsed by strtotime()

Custom date/time format

Optional. A format supported by DateTime::createFromFormat() such as d-m-Y H:i:s

dot notated path (relative to item) for:
item tags

dot notated path (relative to item) for:
item unique ID

Advanced

HTTP username

HTTP password

Use Cookies when fetching the article content

Example: foo=bar; gdpr_consent=true; cookie=value

Accept cookies

Allow the feed server to set cookies (stored in memory for the duration of the request only)

Max HTTP redirects

Set to 0 or leave blank to disable, -1 for unlimited redirects

Set the user agent for fetching this feed

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:86.0)

Set a proxy for fetching this feed

Select a protocol (e.g: SOCKS5) and enter the proxy address (e.g: 127.0.0.1:1080 or username:password@127.0.0.1:1080)

HTTP Method

The POST payload has automatic support for application/x-www-form-urlencoded and application/json

Timeout in seconds

Verify SSL security

HTTP Headers

Headers are separated by a newline, and the name and value of a header are separated by a colon (e.g: Accept: application/atom+xml Authorization: Bearer some-token).

Add a feed or category

Add a category

Add a feed

Add dynamic OPML