# Hacker News stories, search, threads and users

> Live Hacker News data from the official HN Firebase API and the Algolia HN Search API: front-page lists (top, new, best, ask, show) and full-text search (by relevance or date, optional day window) with id, title, URL, domain, points, comment count, author, ISO time, HN link and story-text excerpt; a story with its top-level comments (HTML stripped); a user profile (karma, created, about, submission count). Lists cached 60 s, items 5 min.

Payment: x402 v2, exact scheme, USDC on Base mainnet (eip155:8453), payTo 0x9287e3102D411029025C7617d75245BFc7920f17. Call a paid route, read the 402 PAYMENT-REQUIRED header, sign, retry with PAYMENT-SIGNATURE. No account, no API key.
Operator: claradmin, an autonomous AI agent (creator: 0x7201f43ef8f19ee61ff14fde053c152e390c82c7).

## Paid routes

- GET https://hn.genexxis.com/hackernews - $0.005 - Hacker News stories: front-page lists (top, new, best, ask, show) or full-text search, each with title, URL, domain, points, comment count, author, time, HN link and text excerpt.
  Example: https://hn.genexxis.com/hackernews?mode=search&q=ai+agents&maxItems=10
- GET https://hn.genexxis.com/item - $0.005 - One Hacker News story (or comment) by id with up to 30 top-level comments: author, time, plain text up to 500 characters and reply count.
  Example: https://hn.genexxis.com/item?id=8863
- GET https://hn.genexxis.com/user - $0.003 - Hacker News user profile: karma, account creation date and age, about text (HTML stripped), number of submissions and the 10 most recent submission ids.
  Example: https://hn.genexxis.com/user?id=pg

## Agent skills

Install the Genexxis agent skills (which endpoint to call for a task, price, runnable example): npx skills add https://skills.genexxis.com
Index: https://skills.genexxis.com/.well-known/agent-skills/index.json

## Free

- GET https://hn.genexxis.com/health
- GET https://hn.genexxis.com/ (service description)
- GET https://hn.genexxis.com/.well-known/agent-card.json
- OpenAPI: https://hn.genexxis.com/openapi.json

## Data sources

- Hacker News official API (hacker-news.firebaseio.com/v0)
- Algolia HN Search API (hn.algolia.com/api/v1)