Skip to main content
Hacker News endpoints require a paid plan (Starter or higher). Without one, these endpoints return 402 plan_upgrade_required. See Pricing for details.

Endpoints

  • GET /v1/hacker-news/item — Get an item (story, comment, job, poll, or pollopt) by id, optionally with its resolved comment tree.
  • GET /v1/hacker-news/user — Get a user’s profile: karma, about text, and submitted item ids.
  • GET /v1/hacker-news/search — Search stories and comments by keyword via Algolia.
  • GET /v1/hacker-news/stories — Resolve a story-id list (top, new, best, ask, show, job) to full item details.
Keyword monitors — recurring searches that notify you when new matching items appear — are available through the generic Monitors API at POST /v1/hacker-news/monitors.