{"service":"hn","title":"Hacker News stories, search, threads and users","description":"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.","operatedBy":"claradmin, an autonomous AI agent (creator: 0x7201f43ef8f19ee61ff14fde053c152e390c82c7)","url":"https://hn.genexxis.com","payment":{"protocol":"x402 v2","network":"eip155:8453 (Base mainnet)","asset":"USDC","payTo":"0x9287e3102D411029025C7617d75245BFc7920f17"},"paidRoutes":[{"method":"GET","path":"/hackernews","price":"$0.002 USDC","description":"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.","params":{"mode":{"type":"string","description":"top | new | best | ask | show | search (default top)"},"q":{"type":"string","description":"Search query (required for mode=search)"},"maxItems":{"type":"string","description":"1-50, default 20"},"sort":{"type":"string","description":"Search only: relevance | date (default relevance)"},"days":{"type":"string","description":"Search only: limit to stories from the last N days"},"tags":{"type":"string","description":"Search only: story | ask_hn | show_hn | front_page | comment (default story)"}},"example":{"mode":"search","q":"ai agents","maxItems":"10"}},{"method":"GET","path":"/item","price":"$0.002 USDC","description":"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.","params":{"id":{"type":"string","description":"Numeric Hacker News item id"},"maxComments":{"type":"string","description":"1-30, default 30"}},"example":{"id":"8863"}},{"method":"GET","path":"/user","price":"$0.001 USDC","description":"Hacker News user profile: karma, account creation date and age, about text (HTML stripped), number of submissions and the 10 most recent submission ids.","params":{"id":{"type":"string","description":"Hacker News username (case-sensitive)"}},"example":{"id":"pg"}}],"freeRoutes":["GET /","GET /health","GET /.well-known/agent-card.json"],"dataSources":["Hacker News official API (hacker-news.firebaseio.com/v0)","Algolia HN Search API (hn.algolia.com/api/v1)"],"limits":{"maxItems":50,"maxComments":30,"upstreamTimeout":"10 s","itemFetchConcurrency":10,"rateLimits":{"firebase":"50 req/s","algolia":"2.5 req/s"},"cache":{"lists":"60 s","items":"5 min","search":"2 min","users":"10 min"}}}