Hacker News API

Read-only Hacker News data: any item (story, comment, job, or poll) , public user profiles, ranked story lists (top/new/best and Ask/Show/Job), plus a live-updates feed.

Try it now:
"" Access one-stop/hacker-news-api using the OneStop MCP.

About

Fetch any Hacker News item by numeric id — stories, comments, Ask/Show HN posts, jobs, and polls — and public user profiles by case-sensitive username. List endpoints return current story IDs: up to ~500 for top, new, and best, and up to ~200 for Ask, Show, and Job. The updates endpoint reports recently changed items and profiles, and maxitem returns the current largest item id for walking the full item space.

Overview

The official Hacker News v0 API.

Every story, comment, job, poll, and poll option is an item addressable by numeric id at /v0/item/{id}.json, and user profiles are retrieved by username at /v0/user/{id}.json.\n\n

Typical use: pull a category list (topstories, newstories, beststories — up to ~500 ids; askstories, showstories, jobstories — up to ~200) then fetch each id to assemble a feed. Item objects carry a "kids" array, so you can recurse to reconstruct entire comment threads, and user objects list their submitted item ids.

To track new activity, poll /v0/updates.json for recently changed items and profiles, or read /v0/maxitem.json and walk ids backward.

All responses are JSON.

Endpoints

Base URL:
https://api.onestop.sh/v1/invoke/one-stop/hacker-news-api

Loading endpoints...