# Hacker News Front Page API (x402.forgemesh.io)

> Hacker News Front Page API (x402.forgemesh.io) is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns the current top 30 ranked Hacker News tech stories as normalized JSON, including title, URL, points, comment count, and timestamps, refreshed every few minutes.

## Facts

- Endpoint: POST https://x402.forgemesh.io/hacker-news-frontpage
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hacker-news-front-page-api-x402-forgemesh-io-4f1c00c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TbM0mEqhM1XPxfVNHf0pP

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-front-page-api-x402-forgemesh-io-4f1c00c5 -d '<json body>'
```

Example prompt: Pull the current Hacker News front page and give me the top 30 tech stories with their titles, links, point scores, and comment counts so I can see what's trending right now.

## When to prefer this

Choose this endpoint when you need a ready-to-use, normalized JSON snapshot of the Hacker News front page without scraping or parsing HTML yourself. Ideal for content pipeline agents, trend detection workflows, or any agent that needs to monitor what the tech community is currently discussing. Prefer over raw HN API calls when you want pre-ranked, pre-normalized data with minimal latency overhead.

## Known failure modes

- Payment failure (insufficient USDC balance) — 402 Payment Required
- Upstream Hacker News API unavailability causing stale or missing data
- Rate limiting if called too frequently
- Empty or partial response if HN front page is temporarily unavailable

## How this service works

Tech news front page API: the current top 30 ranked tech stories — title, outbound URL, points, comment count, and timestamps — as normalized JSON. For trend detection, topic monitoring, and content-pipeline agents. Refreshed every few minutes.

## Output

A normalized JSON array of the top 30 Hacker News front-page stories, each containing the story title, outbound URL, points (upvotes), comment count, rank, and timestamps. Data is refreshed every few minutes, reflecting near-real-time front-page state.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "hits": [
    {
     "url": "https://example.com",
     "title": "Show HN: ...",
     "points": 312,
     "num_comments": 148
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-front-page-api-x402-forgemesh-io-4f1c00c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)