API
JSON over the same data the pages render. Read endpoints are open; writes need a session.
-
GET
/api/storiesRanked front page. ?page, ?limit, ?topic, ?sort=top|new|best|ask|show -
GET
/api/item/:idOne story or comment, with its comment tree when it is a story. -
GET
/api/user/:idPublic profile: karma, about, counts. -
GET
/api/search?q=Full listing search. -
GET
/api/topicsChannels and their submission counts. -
POST
/api/vote{ id, dir: "up"|"down" } — session cookie + X-CSRF-Token required. -
POST
/api/submit{ title, url?, text?, topic? } — returns the new item. -
POST
/api/comment{ parent, text } — returns the new comment. -
GET
/rssRSS 2.0 of the current front page.
Rate limit: 60 requests/minute per IP on reads, tighter on writes. Be kind — it is one small server in a shared incubator.