Feeds

Subscribe with Atom or JSON Feed.

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

Quick Start

Daily

Top stories from the last 24 hours.

/feeds/atom?period=day

Open

Weekly

Top stories from the last 7 days.

/feeds/atom?period=week

Open

Feed Builder

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

Core settings

Period Limit

Format

Atom JSON Feed

Categories

Click once to include, twice to exclude, and a third time to turn a pill off.

Story format

All Self Links PDF Video

Keyword Filters

Include keywords Exclude keywords

Threshold Filters

Minimum score Minimum comments

Reference

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`)
`smallweb`, `showhn`, `askhn`, `classics`, `ai`	string	`include` or `exclude`; omit a param to leave that pill off
`content_type`	string	`external`, `self`, `pdf`, or `video`; omit the param or use `all` for no format restriction
`anti_ai`	legacy alias	`anti_ai=true` still maps to `ai=include` on the read path, but canonical URLs always emit `ai`
`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)

← Back to stories