docs / hackernews

Hacker News

Stories, comments, users and full-text search.

base /hackernews/v16 endpoints

post/hackernews/v1/item1 credit

single item by id (story/comment/job/poll/pollopt) — all official fields + time_iso/kids_count/hn_url; hydrate_kids=resolve top-level comments

Parameter	Required
id	required
hydrate_kids	optional
kids_limit	optional

Try in playground →

post/hackernews/v1/item_tree1 credit

full nested comment TREE for a story in ONE call (Algolia items/{id}); recursive children + descendants count

Parameter	Required
id	required

Try in playground →

post/hackernews/v1/user1 credit

user profile by id: karma/created/about/submitted; hydrate_submitted=resolve recent submissions

Parameter	Required
id	required
hydrate_submitted	optional
submitted_limit	optional

Try in playground →

post/hackernews/v1/stories2 credits

story-list (list=top/new/best/ask/show/job) → ranked hydrated stories; offset/limit pagination, hydrate=false for ids only

Parameter	Required
list	optional
limit	optional
offset	optional
hydrate	optional

Try in playground →

post/hackernews/v1/search1 credit

Algolia full-text search: query + tags(story/comment/ask_hn/show_hn/poll/front_page/author_X/story_X) + min_points/max_points/min_comments/before/after + sort(relevance|date), paginated

Parameter	Required
query	optional
tags	optional
sort	optional
page	optional
hits_per_page	optional
min_points	optional
max_points	optional
min_comments	optional
max_comments	optional
before	optional
after	optional
numeric_filters	optional
restrict	optional

Try in playground →

post/hackernews/v1/updates1 credit

live changefeed: recently changed item ids + profiles + max_item; hydrate=resolve changed items

Parameter	Required
hydrate	optional
limit	optional

Try in playground →

Example request · item

curl -X POST https://api.reefapi.com/hackernews/v1/item \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"id":8863}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}