# 2s.io Hacker News Feed

> 2s.io Hacker News Feed is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-13).

Fetches a Hacker News feed (top, new, best, ask, show, or job) with full item metadata including scores, authors, URLs, and timestamps

## Facts

- Endpoint: GET https://2s.io/api/news/hn-top
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-7692b626
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nmlZLxb4VI2JB4lSecG2Z

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 2s-io-7692b626
```

Example prompt: Pull the top 50 stories from Hacker News right now — I want to see titles, scores, authors, and links so I can track what the tech community is buzzing about.

## When to prefer this

Use this endpoint when you need structured Hacker News feed data with rich metadata (scores, authors, timestamps, URLs) in a single call without scraping. Prefer it over raw HN API calls when you need ISO timestamps and canonical URLs pre-formatted, or when you want to filter by feed type (ask, show, job) in one parameter. Best for tech sentiment tracking, topic monitoring, and developer community pulse-checking.

## Known failure modes

- Invalid 'kind' enum value returns an error — must be one of top, new, best, ask, show, job
- limit above 100 is rejected by schema validation
- Payment failure (402) if USDC balance is insufficient
- HN upstream outage may cause stale or empty results
- Network timeout if HN API is slow to respond

## How this service works

Hacker News feed of items. Pass kind = top (default) | new | best | ask | show | job to pick the feed. Returns each item's id, type, author, time (unix + ISO), title, URL, text (for self-posts), score, descendant + kid counts, parent (for comments), dead/deleted flags, and canonical news.ycombinator.com URL. Default limit = 30, max 100. Useful for tech-sentiment + topic tracking.

## Output

A list of up to 100 Hacker News items, each containing id, type, author, unix and ISO timestamps, title, URL, self-post text, score, descendant and kid counts, parent id (for comments), dead/deleted flags, and a canonical news.ycombinator.com URL. Default returns 30 items from the 'top' feed.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "kind": "top",
   "limit": 30
  }
 }
}
```

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "kind": {
       "enum": [
        "top",
        "new",
        "best",
        "ask",
        "show",
        "job"
       ],
       "type": "string",
       "default": "top"
      },
      "limit": {
       "type": "integer",
       "default": 30,
       "maximum": 100,
       "minimum": 1
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-7692b626/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)