# Hacker News Top/New/Best/Ask/Show Stories Feed

> Hacker News Top/New/Best/Ask/Show Stories Feed is a paid API for AI agents from hacker-news.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Fetches up to 15 current Hacker News stories from a selected list (top, new, best, ask, or show) with score, comment count, domain, and age metadata.

## Facts

- Endpoint: GET https://hacker-news.x402tookit.com/hn-top?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hacker-news-top-new-best-ask-show-stories-feed-181397d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8YVe7wQXmlfH_5EdlgLcn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hacker-news-top-new-best-ask-show-stories-feed-181397d3
```

Example prompt: What are the top 15 Hacker News stories right now? Show me the front page — I want the titles, scores, comment counts, and how old each post is.

## When to prefer this

Choose this endpoint when you need a real-time snapshot of the current Hacker News front page or one of its named feeds (top, new, best, ask, show) with rich per-story metadata including scores and comment counts. Prefer it over the search endpoint when you want a ranked feed rather than keyword-filtered results, and over the date-based endpoint when you need live current stories rather than historical archives.

## Known failure modes

- Invalid list type value returns an error or defaults to top
- Limit outside 1-15 range may be clamped or rejected
- Hacker News API downtime causes degraded or empty response (degraded flag set to true)
- Network timeout returns no stories
- Requesting more than 15 stories is not supported

## How this service works

Current Hacker News top, new, best, ask or show stories with score, comment count, domain and age (up to 15).

## Output

Returns a list of up to 15 stories with rank, title, URL, domain, author, score, comment count, age in minutes, posted timestamp, and a text-post flag. Also includes aggregate stats: mean and median score, mean and median comment count, top domains by story count, the list type requested, total stories returned, and a timestamp for when the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "list": {
       "type": "string",
       "description": "top (default), new, best, ask or show"
      },
      "limit": {
       "type": "integer",
       "description": "Stories 1 to 15 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "list": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "stories": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "by": {
          "type": [
           "null",
           "string"
          ]
         },
         "id": {
          "type": [
           "null",
           "number"
          ]
         },
         "age": {
          "type": [
           "null",
           "string"
          ]
         },
         "url": {
          "type": [
           "null",
           "string"
          ]
         },
         "rank": {
          "type": [
           "null",
           "number"
          ]
         },
         "type": {
          "type": [
           "null",
           "string"
          ]
         },
         "score": {
          "type": [
           "null",
           "number"
          ]
         },
         "title": {
          "type": [
           "null",
           "string"
          ]
         },
         "domain": {
          "type": [
           "null",
           "string"
          ]
         },
         "comments": {
          "type": [
           "null",
           "number"
          ]
         },
         "poste
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-top-new-best-ask-show-stories-feed-181397d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hacker-news.x402tookit.com](https://www.zero.xyz/host/hacker-news.x402tookit.com/llms.txt)