Skip to content
onelayer.
All tools

Tool detail

Hacker News Data

Return current Hacker News lists (top/new/best/ask/show/job) or every story, job and poll from one past UTC date, with optional nested comments.

Categories: News

Use when

  • get today's top Hacker News stories
  • pull every Hacker News post from a specific past date
  • fetch a story's comment thread including nested replies

Not for

  • not full-text search of Hacker News -- list/date scans only

Inputs

POST JSON body, all optional: category (top/new/best/ask/show/job) or date (YYYY-MM-DD); limit, comment_limit, reply_depth, replies_per_comment, page_token.

Admitted input schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Which current list to pull from: top, new, best, ask, show, or job. Ignored if a date is given."
    },
    "comment_limit": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many top-level comments to fetch per story in category mode. Default 10, maximum 100, 0 means none."
    },
    "date": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "A calendar day in YYYY-MM-DD format (UTC). If given, the tool switches to scanning that whole day instead of using a category."
    },
    "limit": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "The largest number of results to return. Default is 30, maximum is 200."
    },
    "page_token": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "A resume point from a previous date-scan response, used to continue scanning the same day where it left off."
    },
    "replies_per_comment": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "The largest number of replies fetched per comment at each level. Default 5, maximum 20."
    },
    "reply_depth": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "How many levels of nested replies to fetch below each comment. Default 0, maximum 5."
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://hackernews-data.underscoredone.com/fetch

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base.
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://hackernews-data.underscoredone.com/fetch
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z