# Hacker News Comments API. Comments and replies, page by page.

Comments and replies on a story, in thread order. We handle the proxies, blocks and platform changes.

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

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

## Hacker News Comments API at a glance

Returns the comments on a public Hacker News story, replies included, from its link or item ID. You get them in the thread's own order, newest first or oldest first, each with its text as plain text, author, posting time, reply count, and parent_id and depth to rebuild the thread. Flagged or deleted comments stay in place, marked, while replies hang under them.

GET `/v1/hackernews/comments`

[Read the API reference](https://socialtap.dev/docs/reference/hackernews/comments/index.md)

- **1 credit** per page, $0.75–$1.97 per 1,000 pages
- **16 typed fields** null when unknown
- **1,000** comments and replies per page, Hacker News' own ranking of the comments on the story, each followed by its replies, oldest first, depth first
- **`url`** is all it needs, e.g. `https://news.ycombinator.com/item?id=8863`

## Send one request. Get up to 1,000 comments and replies 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`

`url = https://news.ycombinator.com/item?id=8863`

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

cURL:

```shell
curl -G 'https://socialtap.dev/v1/hackernews/comments' \
  --data-urlencode 'sort=relevance' \
  --data-urlencode 'url=https://news.ycombinator.com/item?id=8863' \
  -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.comments.list({ url: "https://news.ycombinator.com/item?id=8863", sort: "relevance" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  sort: "relevance",
  url: "https://news.ycombinator.com/item?id=8863",
});
const res = await fetch(`https://socialtap.dev/v1/hackernews/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/comments",
    params={"sort": "relevance", "url": "https://news.ycombinator.com/item?id=8863"},
    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("sort", "relevance")
	q.Set("url", "https://news.ycombinator.com/item?id=8863")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/hackernews/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": "BrandonM",
        "is_verified": null,
        "url": "https://news.ycombinator.com/user?id=BrandonM",
        "username": "BrandonM"
      },
      "edited_at": null,
      "id": "9224",
      "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": null,
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "depth": 0,
          "is_dead": false,
          "is_deleted": false,
          "story": null
        }
      },
      "post_id": "8863",
      "published_at": "2007-04-05T15:16:54Z",
      "text": "I have a few qualms with this app:\n\n1. For a Linux user, you can already build such a system yourself quite trivially by getting an FTP account, mounting it locally with curlftpfs, and then using SVN or CVS on the mounted filesystem.  From Windows or Mac, this FTP account could b…",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=9224"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": null,
        "id": "dhouston",
        "is_verified": null,
        "url": "https://news.ycombinator.com/user?id=dhouston",
        "username": "dhouston"
      },
      "edited_at": null,
      "id": "9272",
      "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": "9224",
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "depth": 1,
          "is_dead": false,
          "is_deleted": false,
          "story": null
        }
      },
      "post_id": "8863",
      "published_at": "2007-04-05T16:47:01Z",
      "text": "1. re: the first part, many people want something plug and play. and even if they were plug and play, the problem is that the user experience (on windows at least) with online drives generally sucks, and you don't have disconnected access.\n\nwindows for sure doesn't hide latency w…",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=9272"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": null,
        "id": "BrandonM",
        "is_verified": null,
        "url": "https://news.ycombinator.com/user?id=BrandonM",
        "username": "BrandonM"
      },
      "edited_at": null,
      "id": "9479",
      "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": "9272",
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "depth": 2,
          "is_dead": false,
          "is_deleted": false,
          "story": null
        }
      },
      "post_id": "8863",
      "published_at": "2007-04-06T01:39:04Z",
      "text": "You are correct that this presents a very good, easy-to-install piece of functionality for Windows users.  The Windows shortcomings that you point out are certainly problems, and I think that your software does a good job of overcoming that.\n\nThe part about efficient background s…",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=9479"
    }
  ],
  "page": {
    "has_more": false,
    "next_cursor": null,
    "next_cursor_expires_at": null,
    "end_reason": "end"
  },
  "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": {
      "kind": "post",
      "id": "8863",
      "url": "https://news.ycombinator.com/item?id=8863"
    },
    "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/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

  The story: its link on Hacker News (news.ycombinator.com/item?id=8863, any other query parameters or #fragment kept out) or its item ID alone (8863).
- ### 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 Comments API.

- ### Read the whole discussion under a story
- ### Collect new comments on a story since a date
- ### Rebuild a thread's tree from parent_id and depth
- ### Archive Ask HN and Show HN answers as plain text

## Good to know before you build.

- Comments come in one flat list, replies included: parent_id names the comment each one answers (null for a comment on the story itself) and platform_specific.hackernews.depth how deep it sits.
- In the default order, the comments on the story follow Hacker News' own ranking and the replies under each come oldest first. Hacker News ranks replies too, which this order doesn't follow.
- Hacker News hides comments it flagged and ones their authors deleted. One with replies stays in the list with empty text, marked is_dead or is_deleted in platform_specific.hackernews. One without replies is left out, as on Hacker News.
- When Hacker News Search fails, the default order is read from Hacker News' own API instead, in smaller pages, and reply_count then also counts the flagged and deleted replies Hacker News hides.
- A comment's link or ID lists the replies under it, nested ones too. Their post_id is still the story's.
- Comments are read from Hacker News Search, a copy of Hacker News that can run a minute or two behind, so the newest comments on a busy story may be missing.
- Comment points are hidden on Hacker News, so like_count is null.

## 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/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 Comments API.

More in the [API reference](https://socialtap.dev/docs/reference/hackernews/comments/index.md).

**Are replies to replies included?**

Yes. Replies come in the same flat list, with parent_id naming the comment it answers and depth saying how deep it is.

**Can I get only the comments posted since a date?**

Yes. Send since with sort=newest. Paging stops at that date, so you don't pay for pages of older comments.

**How much does the Hacker News Comments API cost?**

A page of up to 1,000 comments and replies 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 Comments API](https://socialtap.dev/apis/tiktok/comments/index.md) (1 credit / page · `GET /v1/tiktok/comments`)
- [Instagram Comments API](https://socialtap.dev/apis/instagram/comments/index.md) (1 credit / page · `GET /v1/instagram/comments`)
- [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 Comments API](https://socialtap.dev/apis/reddit/comments/index.md) (1 credit / page · `GET /v1/reddit/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 User Comments API](https://socialtap.dev/apis/hackernews/user-comments/index.md) (1 credit / page · `GET /v1/hackernews/user_comments`)
- [Hacker News Comment Search API](https://socialtap.dev/apis/hackernews/search-comments/index.md) (1 credit / page · `GET /v1/hackernews/search_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 on a link you already have.

Paste 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/comments/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
