Hacker News Search — Stories, Comments & Live Front Page
Pricing
from $0.35 / 1,000 result items
Search all of Hacker News (stories, comments, Ask/Show/Launch HN, polls, jobs) by keyword with points, comments, date, author, domain and story filters, or pull the live top/new/best/ask/show/jobs lists. Optional nested comment trees and author profiles.
HN item id
id
Required
Hacker News item id (stable; the discussion page is news.ycombinator.com/item?id=). Always present, also when fields narrows the row.
Item type
type
Optional
story, comment, poll, pollopt or job.
Kind (input)
kind
Optional
The input kind that produced the item (story, comment, show_hn, top, …).
Query
query
Optional
The search query that matched the item; null for live lists and runs without a query.
Title
title
Optional
Submission title; null for comments.
URL
url
Optional
External URL of the submission; null for text posts and comments.
Domain
domain
Optional
HN discussion URL
hnUrl
Optional
The item's page on Hacker News.
Points
points
Optional
Score; null for comments (HN does not publish comment scores).
Comments
numComments
Optional
Number of comments in the thread (stories, polls); null for comments.
Created at
createdAt
Optional
Creation time, ISO 8601 UTC.
Text
text
Optional
Story or comment body as plain text: HTML stripped, entities decoded, paragraphs kept, links as label (href), cut at textMaxLength.
Story id
storyId
Optional
Id of the story the item belongs to (equals id for stories).
Story title
storyTitle
Optional
Title of the parent story (comments only).
Story URL
storyUrl
Optional
External URL of the parent story (comments only).
Parent id
parentId
Optional
Id of the direct parent item (comments, poll options).
Source
source
Optional
algolia (search index) or firebase (official live lists).
Source request
sourceUrl
Optional
The API request that returned the item.
Fetched at
fetchedAt
Optional
Time of the fetch, ISO 8601 UTC.
Comment tree
comments
Optional
Only with includeComments: nested {id, author, createdAt, text, hnUrl, children[]}, breadth-first, cut at commentsDepth / maxCommentsPerStory. [] when the story has no comments or its tree could not be loaded (then counted in SUMMARY.commentsFailed).