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.
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
- 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
urlis 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 socialtapurl = https://news.ycombinator.com/item?id=8863const 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);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"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/hackernews/comments")
uri.query = URI.encode_www_form('sort' => 'relevance', 'url' => 'https://news.ycombinator.com/item?id=8863')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'sort' => 'relevance',
'url' => 'https://news.ycombinator.com/item?id=8863',
]);
$ch = curl_init('https://socialtap.dev/v1/hackernews/comments?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;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"])
}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"{
"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": []
}
}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);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "sort=" + encode("relevance")
+ "&url=" + encode("https://news.ycombinator.com/item?id=8863");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/hackernews/comments?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"sort=" + Uri.EscapeDataString("relevance"),
"url=" + Uri.EscapeDataString("https://news.ycombinator.com/item?id=8863"));
var res = await http.GetAsync("https://socialtap.dev/v1/hackernews/comments?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/hackernews/comments")
.query(&[("sort", "relevance"), ("url", "https://news.ycombinator.com/item?id=8863")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/hackernews/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
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.
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.
Live data from 35 platforms.
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.
| 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.
Are replies to replies included?
Can I get only the comments posted since a date?
How much does the Hacker News Comments API cost?
How do I get the next page?
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 276 endpoints