| Topic | File |
|---|---|
| ------- | ------ |
| API endpoints | api.md |
| Search patterns | search.md |
| API | Use Case | Base URL |
|---|---|---|
| ----- | ---------- | ---------- |
| Official HN API | Single items, real-time | https://hacker-news.firebaseio.com/v0 |
| Algolia Search | Full-text search, filters | https://hn.algolia.com/api/v1 |
/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/search?query=TERM&tags=TAG&numericFilters=FILTER
Tags (combinable with AND):
story, comment, poll, job, ask_hn, show_hnauthor_USERNAME — posts by userstory_ID — comments on storyNumeric filters:
created_at_i>TIMESTAMP — after datepoints>N — minimum pointsnum_comments>N — minimum comments| Request | Endpoint |
|---|---|
| --------- | ---------- |
| Frontpage | Official /topstories.json → fetch first 30 items |
| Search posts | Algolia /search?query=X&tags=story |
| User's posts | Algolia /search?tags=author_USERNAME |
| Who is hiring? | Algolia /search?query=who is hiring&tags=story,author_whoishiring |
| Comments on story | Algolia /search?tags=comment,story_ID |
| This week's top | Algolia /search?tags=story&numericFilters=created_at_i>WEEK_TS |
hits[] arrayid, title, url, score, by, time, descendants (comment count)id, text, by, parent, timepage=N, hitsPerPage=N)url is null for Ask HN/Show HN text posts — use text field insteaddeleted and dead items exist — check before displayingobjectID = HN item id (as string)共 1 个版本