Introducing the Instagram APIRead more →

Hacker News Comment Search API. Comments matching your search.

Comments by keyword, ranked or newest first. We handle the proxies, blocks and platform changes.

In your agent: Hacker News MCP server →

Hacker News Comment Search API at a glance

Returns the public Hacker News comments that match your words, ranked by relevance or newest first. Filter by author, by the story they were posted on, or by date. Each comment has its text as plain text, author, posting time, reply count, the comment it replies to and the title and link of its story.

GET /v1/hackernews/search_comments

Read the API reference
  • 1 credit per page, $0.75–$1.97 per 1,000 pages
  • 16 typed fields null when unknown
  • 100 comments per page, HN Search's ranking: the best match of the words first
  • query is all it needs, e.g. rust borrow checker

Send one request. Get up to 100 comments back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap
query = rust borrow checker
GET /v1/hackernews/search_commentsTry in
const params = new URLSearchParams({
  query: "rust borrow checker",
});
const res = await fetch(`https://socialtap.dev/v1/hackernews/search_comments?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);
200 OK · GET https://socialtap.dev/v1/hackernews/search_commentsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 13 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

  • Null means unknown

    A field Hacker News doesn't show is null, never zero or an empty string, so a real zero always means zero.

  • What it accepts

    Words to find comments by, as HN Search reads them: any word can match with a small typo, a phrase in quotes matches exactly, and a leading - leaves a word out (rust borrow checker, "memory safety" -c++).

  • Write one parser

    Hacker News, TikTok, Instagram and 10 more platforms answer in these fields, so the code that reads one reads them all.

platformstring
Platform ID (tiktok, youtube, …).
idstring
Platform-native comment ID (string; Reddit with its t1_ prefix).
post_idstring
ID of the post commented on (equals post.id).
parent_idstring
ID of the comment this replies to; null for top-level comments.
urlstring
Permalink, when the platform has one.
textstring
Comment body as plain text.
authorobject
The commenting account. An account the platform no longer names (a deleted account) has a null id and username and the platform's label as display_name (Reddit: [deleted]).
published_atstring
When the comment was posted, RFC 3339 UTC. Where the platform shows only a relative time ("3 weeks ago"), the latest time that label allows (the fetch time minus the stated amount), listed in approximate_fields.

What teams build with the Hacker News Comment Search API.

  • Find what Hacker News says about your product

  • Track mentions of a company or library in discussions

  • Collect one user's comments on a topic

  • Search the discussion under one story

  • Gather developer opinions for research

Good to know before you build.

  • Results come from HN Search, the search Hacker News itself links to, which copies every comment within minutes.
  • Hacker News hides comment points from everyone but their author, so like_count is null.
  • sort=relevance serves the first thousand matching comments, then ends with platform_limit. sort=newest walks back through every match.
  • Comments Hacker News killed or that were deleted are not in the results.
  • Words in Chinese, Japanese or Korean match only where they stand apart as words, so they find few comments.

1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

SourcePrice per successful pagePer 1,000 pages
Platform API api1 credit$0.75–$1.97
  • Cache hits are free.
  • Credits from packs and top-ups never expire.
  • A monthly plan's credits are spent first, and what is left of them ends at each renewal.
  • Prices exclude tax: sales tax is added at checkout where it applies.
  • Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Hacker News Comment Search API.

More in the API reference.

How do I search the comments on one Hacker News story?
Send the story's link or ID as story and your words as the query. sort=newest lists the matches newest first.
How much does the Hacker News Comment Search API cost?
A page of up to 100 comments costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.
How do I get the next page?
Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.

Try it with your own search.

Type it in the playground, or copy the request into your code.

100free credits
  • No credit card
  • Failed requests are free
  • Works on all 276 endpoints
Start for free Read the docs