# Vextorium Hacker News Search

> Vextorium Hacker News Search is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Search Hacker News stories or comments by relevance or date, returning points, comment count, author, and links.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hackernews-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hacker-news-search-fec7bff1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_otgtm3L0PdrEBBq6PMS9F

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 vextorium-hacker-news-search-fec7bff1 -d '<json body>'
```

Example prompt: Search Hacker News for the top 10 stories about 'WebAssembly', sorted by relevance, and show me the title, points, and comment count for each.

## When to prefer this

Use this endpoint when you need structured, filterable access to Hacker News content — specifically when you want to retrieve stories or comments by keyword with metadata like points and comment counts. Prefer this over generic web search when the task is specifically about the HN community's discussions, reactions, or coverage of a topic.

## Known failure modes

- Empty results if query matches no indexed HN content
- Invalid enum value for sort or type fields returns a 400 error
- Limit exceeding allowed maximum may be capped or rejected
- Algolia upstream outage causes delayed or failed responses
- Very broad queries may return low-relevance results

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the query, sort method, content type, total result count, and an array of matching items — each containing the story title, external URL, HN post URL, author username, points, comment count, and publication timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "date"
   ],
   "type": "string"
  },
  "type": {
   "enum": [
    "story",
    "comment"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "relevance",
  "type": "story",
  "count": 10,
  "query": "x402",
  "total": 9694,
  "source": "Hacker News (Algolia HN Search API)",
  "results": [
   {
    "url": "https://blog.cloudflare.com/monetization-gateway/",
    "text": null,
    "title": "Monetization Gateway: Charge for any resource behind Cloudflare via x402",
    "author": "soheilpro",
    "hn_url": "https://news.ycombinator.com/item?id=48746914",
    "points": 355,
    "comments": 251,
    "created_at": "2026-07-01T13:59:13Z"
   },
   {
    "url": "https://www.x402.org/",
    "text": null,
    "title": "x402 — An open protocol for internet-native payments",
    "author": "thm",
    "hn_url": "https://news.ycombinator.com/item?id=45347335",
    "points": 228,
    "comments": 147,
    "created_at": "2025-09-23T14:14:46Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hacker-news-search-fec7bff1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)