Назад към всички

Hacker News

// Search and browse Hacker News with API access to stories, comments, users, and hiring threads.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameHacker News
slughacker-news
version1.0.0
descriptionSearch and browse Hacker News with API access to stories, comments, users, and hiring threads.
metadata[object Object]

Quick Reference

TopicFile
API endpointsapi.md
Search patternssearch.md

Core Rules

1. Two APIs Available

APIUse CaseBase URL
Official HN APISingle items, real-timehttps://hacker-news.firebaseio.com/v0
Algolia SearchFull-text search, filtershttps://hn.algolia.com/api/v1

2. Official API Endpoints

  • /topstories.json — top 500 story IDs
  • /newstories.json — newest 500 story IDs
  • /beststories.json — best stories
  • /askstories.json — Ask HN
  • /showstories.json — Show HN
  • /jobstories.json — job postings
  • /item/{id}.json — story/comment details
  • /user/{username}.json — user profile

3. Algolia Search Syntax

/search?query=TERM&tags=TAG&numericFilters=FILTER

Tags (combinable with AND):

  • story, comment, poll, job, ask_hn, show_hn
  • author_USERNAME — posts by user
  • story_ID — comments on story

Numeric filters:

  • created_at_i>TIMESTAMP — after date
  • points>N — minimum points
  • num_comments>N — minimum comments

4. Common Patterns

RequestEndpoint
FrontpageOfficial /topstories.json → fetch first 30 items
Search postsAlgolia /search?query=X&tags=story
User's postsAlgolia /search?tags=author_USERNAME
Who is hiring?Algolia /search?query=who is hiring&tags=story,author_whoishiring
Comments on storyAlgolia /search?tags=comment,story_ID
This week's topAlgolia /search?tags=story&numericFilters=created_at_i>WEEK_TS

5. Response Handling

  • Official API returns IDs → batch fetch items (parallelize)
  • Algolia returns full objects with hits[] array
  • Story object: id, title, url, score, by, time, descendants (comment count)
  • Comment object: id, text, by, parent, time

6. Rate Limits

  • Official API: No auth required, generous limits
  • Algolia: 10,000 requests/hour (no key needed)
  • Always paginate large results (page=N, hitsPerPage=N)

7. Gotchas

  • url is null for Ask HN/Show HN text posts — use text field instead
  • deleted and dead items exist — check before displaying
  • Timestamps are Unix seconds, not milliseconds
  • Algolia objectID = HN item id (as string)