# Hacker News

Hacker News stories, search, threads, users, domain stats and trending topics.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://hacker-news.x402tookit.com/openapi.json
- x402 manifest: https://hacker-news.x402tookit.com/.well-known/x402
- Catalog (free): https://hacker-news.x402tookit.com/catalog
- Health (free): https://hacker-news.x402tookit.com/health
- Uptime (free): https://hacker-news.x402tookit.com/uptime

## Endpoints (7)

### GET /hn-domain-stats — $0.02
Hacker News stories linking to a domain in a date window: count, total points and comments, and the top stories.
Params: domain: string, from: string, to: string, top?: integer
Example: https://hacker-news.x402tookit.com/hn-domain-stats?domain=github.com&from=2025-06-01&to=2025-06-07&top=5

### GET /hn-front-page-date — $0.03
Best-scored Hacker News stories submitted on a UTC date (past front pages are not archived), flagged if still on the front page.
Params: date: string, limit?: integer
Example: https://hacker-news.x402tookit.com/hn-front-page-date?date=2025-10-10&limit=10

### GET /hn-item — $0.02
Summarise a Hacker News item and its comment tree: comment count, depth, authors and top comments, truncated.
Params: id: integer, top?: integer
Example: https://hacker-news.x402tookit.com/hn-item?id=8863&top=3

### GET /hn-search — $0.02
Search Hacker News stories or comments by query with optional date range, sorted by relevance or date.
Params: query: string, tags?: string, from?: string, to?: string, sort?: string, limit?: integer
Example: https://hacker-news.x402tookit.com/hn-search?query=rust&tags=story&from=2025-01-01&to=2025-12-31&sort=relevance&limit=10

### GET /hn-top — $0.02
Current Hacker News top, new, best, ask or show stories with score, comment count, domain and age (up to 15).
Params: list?: string, limit?: integer
Example: https://hacker-news.x402tookit.com/hn-top?list=top&limit=10

### GET /hn-trending-topics — $0.03
Trending keywords across current Hacker News stories: terms ranked by how many titles use them, with example titles.
Params: list?: string, stories?: integer, top?: integer
Example: https://hacker-news.x402tookit.com/hn-trending-topics?list=top&stories=15&top=10

### GET /hn-user — $0.03
Hacker News user profile: karma, account age, submission count and recent story/comment activity with top story.
Params: username: string
Example: https://hacker-news.x402tookit.com/hn-user?username=pg

## Terms

Data comes from the public Hacker News Firebase and Algolia HN Search APIs, provided as is. Scores, ranks and counts change constantly; search can miss items; story text belongs to its authors. Not affiliated with Y Combinator. Not financial or investment advice.