scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTPost
  • POSTSearch

HackerNews Post

Free

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.

numberOfPagesnumber

Comment-depth compatibility control. Set it to 1 to fetch first-level comments only. Omit it to include nested comments, subject to maxComments. Values greater than 1 are accepted and have the same depth behavior as an omitted value.

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 (0)

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": 0,
    "requestId": "req_abc123"
  }
}