Hacker News User Comments API. Comments, page by page.
Every comment a user wrote, newest first. We handle the proxies, blocks and platform changes.
Hacker News User Comments API at a glance
Returns a Hacker News user's comments, newest first, from a username or a link to the user. Each comment comes with its text as plain text, posting time, link, the story it is on with that story's title and link, the comment it replies to, and its reply count. Page back through the user's whole history, or set since and until for a time range. An unknown username returns not_found.
GET /v1/hackernews/user_comments
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 16 typed fields null when unknown
- 100 comments per page, newest first
handleis all it needs, e.g.pg
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 socialtaphandle = pgconst params = new URLSearchParams({
handle: "rtm",
});
const res = await fetch(`https://socialtap.dev/v1/hackernews/user_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/user_comments",
params={"handle": "rtm"},
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/user_comments")
uri.query = URI.encode_www_form('handle' => 'rtm')
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([
'handle' => 'rtm',
]);
$ch = curl_init('https://socialtap.dev/v1/hackernews/user_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("handle", "rtm")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/hackernews/user_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 'https://socialtap.dev/v1/hackernews/user_comments?handle=rtm' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [],
"author": {
"avatar_url": null,
"display_name": null,
"id": "rtm",
"is_verified": null,
"url": "https://news.ycombinator.com/user?id=rtm",
"username": "rtm"
},
"edited_at": null,
"id": "5233445",
"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": "5230589",
"platform": "hackernews",
"platform_specific": {
"hackernews": {
"depth": null,
"is_dead": false,
"is_deleted": false,
"story": {
"comment_count": null,
"link_url": null,
"points": null,
"published_at": null,
"title": "HN will be down Saturday morning while we switch servers"
}
}
},
"post_id": "5229364",
"published_at": "2013-02-16T23:11:51Z",
"text": "Old server: two Xeon E5450 chips, 3.0 GHz, 8 cores total, 24 GB RAM.\n\nNew server: one Xeon E5-2690 chip, 2.9 GHz, 8 cores total, 32 GB RAM.",
"unknown_fields": [],
"url": "https://news.ycombinator.com/item?id=5233445"
},
{
"approximate_fields": [],
"author": {
"avatar_url": null,
"display_name": null,
"id": "rtm",
"is_verified": null,
"url": "https://news.ycombinator.com/user?id=rtm",
"username": "rtm"
},
"edited_at": null,
"id": "5231080",
"is_by_post_author": null,
"is_edited": null,
"is_liked_by_author": null,
"is_pinned": null,
"metrics": {
"like_count": null,
"reply_count": 2
},
"parent_id": null,
"platform": "hackernews",
"platform_specific": {
"hackernews": {
"depth": 0,
"is_dead": false,
"is_deleted": false,
"story": {
"comment_count": null,
"link_url": null,
"points": null,
"published_at": null,
"title": "[dead]"
}
}
},
"post_id": "5231079",
"published_at": "2013-02-16T10:17:47Z",
"text": "Test comment.",
"unknown_fields": [],
"url": "https://news.ycombinator.com/item?id=5231080"
},
{
"approximate_fields": [],
"author": {
"avatar_url": null,
"display_name": null,
"id": "rtm",
"is_verified": null,
"url": "https://news.ycombinator.com/user?id=rtm",
"username": "rtm"
},
"edited_at": null,
"id": "4848185",
"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": null,
"platform": "hackernews",
"platform_specific": {
"hackernews": {
"depth": 0,
"is_dead": false,
"is_deleted": false,
"story": {
"comment_count": null,
"link_url": "http://www.theverge.com/2012/11/29/3702668/acer-c7-chromebook-review-199-laptop",
"points": null,
"published_at": null,
"title": "Acer C7 Chromebook review"
}
}
},
"post_id": "4848179",
"published_at": "2012-11-29T15:31:28Z",
"text": "xxxxx",
"unknown_fields": [],
"url": "https://news.ycombinator.com/item?id=4848185"
}
],
"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": "profile",
"id": "rtm",
"url": "https://news.ycombinator.com/user?id=rtm"
},
"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.userComments.list({ handle: "rtm" });
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 = "handle=" + encode("rtm");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/hackernews/user_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("&",
"handle=" + Uri.EscapeDataString("rtm"));
var res = await http.GetAsync("https://socialtap.dev/v1/hackernews/user_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/user_comments")
.query(&[("handle", "rtm")])
.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/user_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 Hacker News user: a username (case-sensitive: pg, not PG) or a link to the user's page or one of its lists (news.ycombinator.com/user?id=pg, threads?id=pg).
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 User Comments API.
Archive everything a known commenter wrote
Track what a founder says about their product
Find the stories a user joins in on
Study one person's views over the years
Vet a candidate's public comments
Good to know before you build.
- Usernames are case-sensitive on Hacker News: a username in the wrong case returns not_found.
- Comments come from HN Search, which copies new comments within minutes. If it fails, we read the user's comments pages on Hacker News instead: the same comments, with the story's title but not its link.
- Hacker News' own pages list each thread under the user's comment that starts it, so on that fallback a reply inside an older thread can come a page late, and a walk with since can stop before reaching it.
- Comments that were deleted or that Hacker News killed are left out.
- Hacker News shows nobody a comment's points but its author, 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 |
Public page page | 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 User Comments API.
More in the API reference.
Can I get every comment a Hacker News user ever wrote?
How much does the Hacker News User Comments API cost?
How do I get the next page?
Try it on an account you know.
Paste its handle or link in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 276 endpoints