Tutorials
Hacker News search in curl
One authenticated call to /api/v1/hackernews/search?q=rust&limit=25, the response it returned, and the line that reads one field out of it.
What you need
curl ships with macOS and most Linux distributions, and with Windows 10 and later. There is nothing to install.
The call
curl -H "Authorization: Bearer $HH_KEY" \
"https://honesthook.com/api/v1/hackernews/search?q=rust&limit=25"
What came back
{
"success": true,
"platform": "hackernews",
"endpoint": "hackernews/search",
"data": {
"author": {
"id": null,
"handle": null,
"followers": null
},
"items": [
{
"id": "46990729",
"title": "An AI agent published a hit piece on me",
"url": "https://news.ycombinator.com/item?id=46990729",
"published_at": "2026-09-28T11:04:22.000Z",
"metrics": { "points": 412, "comments": 176 },
"position": 1
}
],
"has_more": null
},
"error": null,
"cached": false
}
Recorded response, captured 30 Sep 2026. A live call returns the value at the moment you ask, not this one.
Every field in that capture
| In curl | Type in this capture |
|---|
.success | boolean |
.platform | string |
.endpoint | string |
.data.author.id | null |
.data.author.handle | null |
.data.author.followers | null |
.data.items | array (1 in this capture) |
.data.has_more | null |
.error | null |
.cached | boolean |
A field we cannot read comes back null, never 0. A zero would be a claim about the account; null is a fact about our collection. The full list of what this route does not return is on hackernews-api/search.
Reading one field
curl -H "Authorization: Bearer $HH_KEY" \
"https://honesthook.com/api/v1/hackernews/search?q=rust&limit=25" \
| jq -r '.data.items'
jq is a separate tool — it is not part of curl. Without it the command above prints the whole envelope, which is the block below.
Every other tutorial here reads somebody's profile. This one does not, and the difference shows up in the response: there is no account to describe, so the author fields are null and the thing you want is items.
Hacker News has no follow graph. There is no follower count to return, and no profile endpoint either — that absence is a decision, not a gap.
What you are calling
One authenticated GET to our endpoint, with your key in an Authorization header. Behind it is the public Algolia index of Hacker News. The query in the example is the one that produced the recorded response below.
Each item carries its title, its link, when it was posted, and its points and comment count. The response shows one item; a real call returns the page you asked for.
Two things about the index
It does not understand OR. A query written as a boolean expression is read as words, so you get results for the words — not an error telling you the operator was ignored.
And typo tolerance is on by default, which means a short query can return a page of results that have nothing to do with what you typed while looking like a perfectly successful search. Check that the titles are about your subject before you count anything.
Before you copy the block
Keep the key in an environment variable — all three examples read HH_KEY.