Hacker News RSS feeds

Overview

hnrss.org provides custom, realtime RSS feeds for Hacker News.

The following feeds are available:

Details

Each feed is valid RSS served over HTTPS.

Firehose Feeds

The “firehose” feeds contain all new posts and comments as they appear on Hacker News:

https://hnrss.org/newest
https://hnrss.org/newcomments

For just the posts that have appeared on the front page:

https://hnrss.org/frontpage

If the firehose feeds are a bit too noisy for you, read below on filtering them with the points and/or comments parameters.

Search Feeds

You can get a feed of new posts and/or comments containing keywords by using the q=KEYWORD parameter. For example:

https://hnrss.org/newest?q=Django
https://hnrss.org/newcomments?q=WordPress

If you want a single search feed but multiple keywords, separate the keywords with “ OR “:

https://hnrss.org/newest?q=git+OR+linux

Self Post Feeds

Ask HN, Show HN, and polls are available:

https://hnrss.org/ask
https://hnrss.org/show
https://hnrss.org/polls

User Feeds

If you don’t want to miss a post or comment by a given user, you can subscribe to that user’s feed:

https://hnrss.org/submitted?id=USERNAME # posts
https://hnrss.org/threads?id=USERNAME   # comments
https://hnrss.org/user?id=USERNAME      # everything

Thread Feeds

A feed of new comments on a particular post can be found at:

https://hnrss.org/item?id=THREAD_ID

With THREAD_ID the numerical ID found in the URL when viewing the comments page.

Feed Options

You can modify any feed’s output using URL parameters. Multiple parameters can be applied at the same time by joining them with an ampersand.

Activity Parameters

You can apply a points=N or comments=N parameter to any feed to filter the results so only entries with more than N points or comments are shown:

https://hnrss.org/newest?points=100
https://hnrss.org/ask?comments=25

You can also combine both parameters:

https://hnrss.org/show?points=100&comments=25

Unfortunately, /newcomments does not work with a points=N parameter.

Search Parameter

By default, searches on posts only look at titles. If you want to search against the submitted URLs themselves, use the search_attrs parameter.

Here are some examples:

By default, the RSS <link> element points to the submitted article’s URL. The <link> element can be changed to point to the Hacker News comment page by appending link=comments to the end of the URL. For example:

https://hnrss.org/newest?link=comments

Description Parameter

You can disable the <description> element entirely by passing the description=0 parameter:

https://hnrss.org/newest?description=0

Count Parameter

By default, feeds return 20 RSS items. This can be increased via the count=N parameter:

https://hnrss.org/newest?count=50

There is a hardcoded limit of 100 entries, so keep that in mind.

ChangeLog

Support

hnrss.org is a labor of love, but if the project has made your job or hobby project easier and you want to show some gratitude, donations are very much appreciated. Thanks!

Donate

Donate

Credits & Colophon

hnrss.org uses Algolia to query Hacker News and generate the feeds. The code is a Flask app. It runs on nginx with Varnish providing a cache layer and Let’s Encrypt providing HTTPS.

This documentation is built with Hugo, rendered using the Go font family, and hosted on Github Pages.

The source of the app and the documentation are hosted on Github.