Feeds

Subscribe with Atom or JSON Feed.

Each feed returns the top stories within the time frame you choose.

Quick Start

Build a feed URL from the same story filters you already use on the site.

Core settings

Period Limit

Format

Atom JSON Feed

Story type

Any PDF Video

Story filters

Small Web Show HN Ask HN Vintage

Keyword Filters

Include keywords Exclude keywords

Threshold Filters

Minimum score Minimum comments

Parameter	Type	Description
`period`	string (required)	`day`, `3day`, `week`, or `month`, rolling window
`limit`	integer	Number of stories to pull. Think of it as the top `x` stories for that rolling period. Range: `1` through `200` (`default = 50`)
`ctype`	string	`pdf` or `video`; omit it to return all story types (`default = omitted`)
`smallweb`, `showhn`, `askhn`, `classics`	boolean	Add with `=true` (`default = false`)
`include_keywords`	string	Only include matching stories (optional)
`exclude_keywords`	string	Exclude matching stories (optional)
`min_score`	integer	Minimum score (optional)
`min_comments`	integer	Minimum comments (optional)