# Hacker News Comment Search API. Comments matching your search.

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

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dhackernews.search_comments)

[In your agent: **Hacker News MCP server** →](https://socialtap.dev/mcp/hackernews/index.md)

## 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](https://socialtap.dev/docs/reference/hackernews/search-comments/index.md)

- **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`

[Open in playground](https://socialtap.dev/playground/?endpoint=hackernews.search_comments)

cURL:

```shell
curl -G 'https://socialtap.dev/v1/hackernews/search_comments' \
  --data-urlencode 'query=rust borrow checker' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.hackernews.searchComments.list({ query: "rust borrow checker" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
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);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/hackernews/search_comments",
    params={"query": "rust borrow checker"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("query", "rust borrow checker")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/hackernews/search_comments?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": [
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": null,
        "id": "Animats",
        "is_verified": null,
        "url": "https://news.ycombinator.com/user?id=Animats",
        "username": "Animats"
      },
      "edited_at": null,
      "id": "9948436",
      "is_by_post_author": null,
      "is_edited": null,
      "is_liked_by_author": null,
      "is_pinned": null,
      "metrics": {
        "like_count": null,
        "reply_count": 0
      },
      "parent_id": "9947256",
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "depth": null,
          "is_dead": false,
          "is_deleted": false,
          "story": {
            "comment_count": null,
            "link_url": "https://www.justsoftwaresolutions.co.uk/cplusplus/shared-ptr-secret-constructor.html",
            "points": null,
            "published_at": null,
            "title": "Std::shared_ptr's secret constructor"
          }
        }
      },
      "post_id": "9946625",
      "published_at": "2015-07-25T18:14:21Z",
      "text": "\"Interesting, but in most circumstances I think this falls into the \"too clever\" category. As with most of C++'s weirder features, you really only want to use them when you absolutely have to.\"\n\nThe C++ committee has been trying to get ownership semantics to work right for about …",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=9948436"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": null,
        "id": "catnaroek",
        "is_verified": null,
        "url": "https://news.ycombinator.com/user?id=catnaroek",
        "username": "catnaroek"
      },
      "edited_at": null,
      "id": "9858523",
      "is_by_post_author": null,
      "is_edited": null,
      "is_liked_by_author": null,
      "is_pinned": null,
      "metrics": {
        "like_count": null,
        "reply_count": 0
      },
      "parent_id": "9853004",
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "depth": null,
          "is_dead": false,
          "is_deleted": false,
          "story": {
            "comment_count": null,
            "link_url": "http://devblog.avdi.org/2015/07/08/ruby-is-defined-by-terrible-tools/",
            "points": null,
            "published_at": null,
            "title": "Ruby Is Defined by Terrible Tools"
          }
        }
      },
      "post_id": "9851685",
      "published_at": "2015-07-09T15:42:52Z",
      "text": "You're confusing \"sophisticated\" with \"annoying or difficult to use\". Boilerplate generators are annoying, and Valgrind is difficult to use, but they're unrefined: they solve problems that are best avoided than solved.\n\nA better measure of sophistication is how much bang you get …",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=9858523"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": null,
        "id": "Aatch",
        "is_verified": null,
        "url": "https://news.ycombinator.com/user?id=Aatch",
        "username": "Aatch"
      },
      "edited_at": null,
      "id": "9783186",
      "is_by_post_author": null,
      "is_edited": null,
      "is_liked_by_author": null,
      "is_pinned": null,
      "metrics": {
        "like_count": null,
        "reply_count": 1
      },
      "parent_id": "9781361",
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "depth": null,
          "is_dead": false,
          "is_deleted": false,
          "story": {
            "comment_count": null,
            "link_url": "http://blog.rust-lang.org/2015/06/25/Rust-1.1.html",
            "points": null,
            "published_at": null,
            "title": "Rust 1.1 Stable, the Community Subteam, and RustCamp"
          }
        }
      },
      "post_id": "9779757",
      "published_at": "2015-06-26T09:38:05Z",
      "text": "Eh, at the end of the day, they're different languages and are following different paths. Sure they're superficially similar, but that's not all to it.\n\nPython and Ruby are pretty similar languages overall, but neither has \"killed\" the other. Why? Because despite their similiarit…",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=9783186"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "hackernews",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": null,
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 13 platforms.

The [response reference](https://socialtap.dev/docs/reference/hackernews/search-comments/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/comment/index.md).

- ### 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.

- **`platform`string**: Platform ID (tiktok, youtube, …).
- **`id`string**: Platform-native comment ID (string; Reddit with its t1_ prefix).
- **`post_id`string**: ID of the post commented on (equals post.id).
- **`parent_id`string**: ID of the comment this replies to; null for top-level comments.
- **`url`string**: Permalink, when the platform has one.
- **`text`string**: Comment body as plain text.
- **`author`object**: 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_at`string**: 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.

Live data from 35 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [GitHub](https://socialtap.dev/apis/github/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Hacker News](https://socialtap.dev/apis/hackernews/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/page/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/profile/index.md) · [Linkme](https://socialtap.dev/apis/linkme/profile/index.md) · [Linktree](https://socialtap.dev/apis/linktree/profile/index.md) · [Pillar](https://socialtap.dev/apis/pillar/page/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## 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.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/hackernews/search-comments/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful page | Per 1,000 pages |
| --- | --- | --- |
| Platform API `api` | 1 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](https://socialtap.dev/docs/reference/hackernews/search-comments/index.md).

**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.

Other platforms

## Comments on 12 more platforms.

- [TikTok Comment API](https://socialtap.dev/apis/tiktok/comment/index.md) (1 credit · `GET /v1/tiktok/comment`)
- [Instagram Comment API](https://socialtap.dev/apis/instagram/comment/index.md) (1 credit · `GET /v1/instagram/comment`)
- [Facebook Comments API](https://socialtap.dev/apis/facebook/comments/index.md) (1 credit / page · `GET /v1/facebook/comments`)
- [YouTube Comments API](https://socialtap.dev/apis/youtube/comments/index.md) (1 credit / page · `GET /v1/youtube/comments`)
- [Reddit Comment Search API](https://socialtap.dev/apis/reddit/search-comments/index.md) (1 credit / page · `GET /v1/reddit/search_comments`)
- [Threads Comments API](https://socialtap.dev/apis/threads/comments/index.md) (1 credit / page · `GET /v1/threads/comments`)
- [GitHub Issue Comments API](https://socialtap.dev/apis/github/issue-comments/index.md) (1 credit / page · `GET /v1/github/issue_comments`)
- [LinkedIn Comments API](https://socialtap.dev/apis/linkedin/comments/index.md) (From 1 credit / page · `GET /v1/linkedin/comments`)
- [X (Twitter) Comments API](https://socialtap.dev/apis/x/comments/index.md) (1 credit / page · `GET /v1/x/comments`)
- [Rumble Comments API](https://socialtap.dev/apis/rumble/comments/index.md) (1 credit / page · `GET /v1/rumble/comments`)
- [Bluesky Comments API](https://socialtap.dev/apis/bluesky/comments/index.md) (1 credit / page · `GET /v1/bluesky/comments`)
- [Snapchat Comments API](https://socialtap.dev/apis/snapchat/comments/index.md) (1 credit / page · `GET /v1/snapchat/comments`)

More Hacker News

## Hacker News API. 11 endpoints, one key.

- [Hacker News Story API](https://socialtap.dev/apis/hackernews/story/index.md) (1 credit · `GET /v1/hackernews/story`)
- [Hacker News Feed API](https://socialtap.dev/apis/hackernews/feed-stories/index.md) (1 credit / page · `GET /v1/hackernews/feed_stories`)
- [Hacker News Search API](https://socialtap.dev/apis/hackernews/search-stories/index.md) (1 credit / page · `GET /v1/hackernews/search_stories`)
- [Hacker News User Stories API](https://socialtap.dev/apis/hackernews/user-stories/index.md) (1 credit / page · `GET /v1/hackernews/user_stories`)
- [Hacker News User Favorites API](https://socialtap.dev/apis/hackernews/user-favorites/index.md) (1 credit / page · `GET /v1/hackernews/user_favorites`)
- [Hacker News User API](https://socialtap.dev/apis/hackernews/user/index.md) (1 credit · `GET /v1/hackernews/user`)
- [Hacker News Comment API](https://socialtap.dev/apis/hackernews/comment/index.md) (1 credit · `GET /v1/hackernews/comment`)
- [Hacker News Comments API](https://socialtap.dev/apis/hackernews/comments/index.md) (1 credit / page · `GET /v1/hackernews/comments`)
- [Hacker News User Comments API](https://socialtap.dev/apis/hackernews/user-comments/index.md) (1 credit / page · `GET /v1/hackernews/user_comments`)
- [Hacker News Who Is Hiring API](https://socialtap.dev/apis/hackernews/whoishiring-jobs/index.md) (1 credit / page · `GET /v1/hackernews/whoishiring_jobs`)

## 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](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/hackernews/search-comments/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
