Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

query
string
required

Search keyword(s)

Minimum string length: 1
tags
enum<string>[]

Restrict results to these Algolia HN tags

Available options:
story,
comment,
poll,
pollopt,
show_hn,
ask_hn,
front_page
since
integer

Only include results created after this unix timestamp (seconds)

Required range: 0 <= x <= 9007199254740991
sort
enum<string>

relevance (default) uses /search, date uses /search_by_date

Available options:
relevance,
date
page
integer

0-indexed result page

Required range: 0 <= x <= 9007199254740991
hits_per_page
integer

Results per page, max 100

Required range: x <= 100

Response

Structured Hacker News search results.

provider
enum<string>
required
Available options:
hacker_news
request_id
string
required
query
string
required
hits
object[]
required
page
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
total_pages
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
total_hits
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991