scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTPost
  • POSTSearch

HackerNews Post

1 credit

Get a HackerNews post with its comments.

POST/api/v1/tools/hackernews/post

Parameters

itemIdstringrequired

HackerNews item ID (numeric string, e.g. "40123456").

maxCommentsnumber

Maximum number of comments to return. Must be a positive integer. Defaults to 200. Upper bound is determined by your plan.

fieldsstring[]

Fields to include per comment. Omit for defaults: id, author, text, createdAt, parentId. Use ["*"] for all fields. The post wrapper is always returned.

Response Schema

dataobject

HackerNews post result

postobject | null

Post metadata

commentsobject[]

Array of comment objects. Fields depend on the fields parameter. Default fields: id, author, text, createdAt, parentId.

countnumber

Number of comments returned

totalCommentsnumber | null

Total descendant count reported by HN

metaobject

Request metadata

toolstring

Tool name (hackernews-post)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/hackernews/post \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"itemId": "40123456",
"maxComments": 100
}'

Response Example

{
"data": {
"post": {
"id": "40123456",
"author": "pg",
"title": "Show HN: A new way to build web apps",
"text": null,
"url": "https://example.com/launch",
"createdAt": "2026-04-08T14:00:00.000Z",
"score": 512,
"descendants": 203
},
"comments": [
{
"id": "40123500",
"parentId": "40123456",
"author": "dang",
"text": "Interesting approach. How does this compare to existing frameworks?",
"createdAt": "2026-04-08T14:15:00.000Z"
}
],
"count": 1,
"totalComments": 203
},
"meta": {
"tool": "hackernews-post",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}