{"openapi":"3.1.0","info":{"title":"Hacker News","version":"1.0.0","description":"Hacker News stories, search, threads, users, domain stats and trending topics. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Hacker News: Hacker News stories, search, threads, users, domain stats and trending topics. /hn-top (top, new, best, ask or show stories with score, comments, domain and age), /hn-search (Algolia search by query, tags, dates and sort), /hn-item (thread summary: comment count, depth and top comments), /hn-user (karma, account age and recent activity), /hn-domain-stats (stories from a domain in a window), /hn-front-page-date (best-scored stories of a UTC day), /hn-trending-topics (most frequent title keywords across current stories). Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://hacker-news.x402tookit.com"}],"paths":{"/hn-domain-stats":{"get":{"operationId":"hn_domain_stats","summary":"Hacker News stories linking to a domain in a date window: count, total points and comments, and the top stories.","description":"Hacker News stories linking to a domain in a date window: count, total points and comments, and the top stories.","tags":["hackernews","domain","stats","links"],"parameters":[{"name":"domain","in":"query","required":true,"description":"Domain such as github.com (subdomains included)","schema":{"type":"string"}},{"name":"from","in":"query","required":true,"description":"First UTC day YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Last UTC day YYYY-MM-DD (inclusive, window up to 366 days)","schema":{"type":"string"}},{"name":"top","in":"query","required":false,"description":"Top stories to list, 1 to 10 (default 5)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"domain":{"type":["null","string"]},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"storiesCounted":{"type":["null","number"]},"searchMatches":{"type":["null","number"]},"partial":{"type":["boolean","null"]},"totalPoints":{"type":["null","number"]},"totalComments":{"type":["null","number"]},"avgPoints":{"type":["null","number"]},"storiesOver100Points":{"type":["null","number"]},"topStories":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","number"]},"title":{"type":["null","string"]},"by":{"type":["null","string"]},"points":{"type":["null","number"]},"comments":{"type":["null","number"]},"domain":{"type":["null","string"]},"url":{"type":["null","string"]},"postedAt":{"type":["null","string"]},"discussion":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"STATS_COMPUTED","summary":"100+ stories from github.com between 2025-06-01 and 2025-06-07: 7113 points, 3028 comments; best \"Cloudlflare builds OAuth with Claude and publishes all the p\" (889).","reasons":["The search matched 395 items but only the first 100 (relevance order) were tallied, so counts and totals are lower bounds."],"domain":"github.com","from":"2025-06-01","to":"2025-06-07","storiesCounted":100,"searchMatches":395,"partial":true,"totalPoints":7113,"totalComments":3028,"avgPoints":71.1,"storiesOver100Points":18,"topStories":[{"id":44159166,"title":"Cloudlflare builds OAuth with Claude and publishes all the prompts","by":"gregorywegory","points":889,"comments":529,"domain":"github.com","url":"https://github.com/cloudflare/workers-oauth-provider/","postedAt":"2025-06-02T14:24:54Z","discussion":"https://news.ycombinator.com/item?id=44159166"},{"id":44183799,"title":"A proposal to restrict sites from accessing a users’ local network","by":"doener","points":680,"comments":376,"domain":"github.com","url":"https://github.com/explainers-by-googlers/local-network-access","postedAt":"2025-06-04T18:15:54Z","discussion":"https://news.ycombinator.com/item?id=44183799"}],"degraded":false,"notChecked":["link-shortener or redirect URLs that hide the domain","stories past the first 100 search hits (see partial)","…1 more"],"source":"Algolia HN Search","sourceUrl":"https://hn.algolia.com/api","asOf":"2026-10-21T00:39:12.701Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-domain-stats"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-domain-stats"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-domain-stats"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-domain-stats"}}]}}},"/hn-front-page-date":{"get":{"operationId":"hn_front_page_date","summary":"Best-scored Hacker News stories submitted on a UTC date (past front pages are not archived), flagged if still on the front page.","description":"Best-scored Hacker News stories submitted on a UTC date (past front pages are not archived), flagged if still on the front page.","tags":["hackernews","front-page","history","date"],"parameters":[{"name":"date","in":"query","required":true,"description":"UTC day YYYY-MM-DD, not in the future","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Stories 1 to 30 (default 15)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"date":{"type":["null","string"]},"basis":{"type":["null","string"]},"storiesScoring20Plus":{"type":["null","number"]},"returned":{"type":["null","number"]},"stories":{"type":["array","null"],"items":{"type":"object","properties":{"rank":{"type":["null","number"]},"id":{"type":["null","number"]},"title":{"type":["null","string"]},"by":{"type":["null","string"]},"points":{"type":["null","number"]},"comments":{"type":["null","number"]},"domain":{"type":["null","string"]},"url":{"type":["null","string"]},"postedAt":{"type":["null","string"]},"discussion":{"type":["null","string"]},"onFrontPageNow":{"type":["boolean","null"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"BEST_OF_DAY","summary":"2025-10-10: 96 stories scored 20+ points; best \"Liquid Glass Is Cracked, and Usability Suffers in iOS 26\" with 752 points. Ranked by points, not the archived front page.","reasons":["Hacker News does not archive its past front pages and the Algolia front_page tag only covers the current page, so this lists the highest-scored stories submitted that UTC day instead."],"date":"2025-10-10","basis":"highest points among stories submitted that UTC day (score >= 20)","storiesScoring20Plus":96,"returned":10,"stories":[{"rank":1,"id":45544044,"title":"Liquid Glass Is Cracked, and Usability Suffers in iOS 26","by":"uxjw","points":752,"comments":526,"domain":"nngroup.com","url":"https://www.nngroup.com/articles/liquid-glass/","postedAt":"2025-10-10T21:35:22Z","discussion":"https://news.ycombinator.com/item?id=45544044","onFrontPageNow":false},{"rank":2,"id":45539943,"title":"Ryanair flight landed at Manchester airport with six minutes of fuel left","by":"mazokum","points":734,"comments":557,"domain":"theguardian.com","url":"https://www.theguardian.com/business/2025/oct/10/ryanair-flight-landed-at-manchester-airport-with-six-minutes-of-fuel-left-flight-log-suggests","postedAt":"2025-10-10T15:11:04Z","discussion":"https://news.ycombinator.com/item?id=45539943","onFrontPageNow":false}],"degraded":false,"notChecked":["the actual front page of that day (HN does not archive it; this ranks by points)","stories under 20 points","…2 more"],"source":"Algolia HN Search","sourceUrl":"https://hn.algolia.com/api","asOf":"2026-10-21T00:39:14.667Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-front-page-date"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-front-page-date"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-front-page-date"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-front-page-date"}}]}}},"/hn-item":{"get":{"operationId":"hn_item","summary":"Summarise a Hacker News item and its comment tree: comment count, depth, authors and top comments, truncated.","description":"Summarise a Hacker News item and its comment tree: comment count, depth, authors and top comments, truncated.","tags":["hackernews","thread","comments","item"],"parameters":[{"name":"id","in":"query","required":true,"description":"Item id, e.g. 8863 (the number in news.ycombinator.com/item?id=)","schema":{"type":"integer"}},{"name":"top","in":"query","required":false,"description":"Top-level comments to excerpt, 0 to 10 (default 5)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"id":{"type":["null","number"]},"type":{"type":["null","string"]},"title":{"type":["null","string"]},"by":{"type":["null","string"]},"points":{"type":["null","number"]},"postedAt":{"type":["null","string"]},"url":{"type":["null","string"]},"domain":{"type":["null","string"]},"textExcerpt":{},"comments":{"type":["null","number"]},"topLevelComments":{"type":["null","number"]},"maxDepth":{"type":["null","number"]},"uniqueCommenters":{"type":["null","number"]},"topComments":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","number"]},"by":{"type":["null","string"]},"postedAt":{"type":["null","string"]},"replies":{"type":["null","number"]},"excerpt":{"type":["null","string"]}}}},"discussion":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"ITEM_SUMMARISED","summary":"\"My YC app: Dropbox - Throw away your USB drive\" by dhouston: 71 comments, depth 5, 41 authors, 104 points.","reasons":["Top comments are in the source's own order (top-level replies, ranked by the site)."],"id":8863,"type":"story","title":"My YC app: Dropbox - Throw away your USB drive","by":"dhouston","points":104,"postedAt":"2007-04-04T19:16:40.000Z","url":"http://www.getdropbox.com/u/2/screencast.html","domain":"getdropbox.com","textExcerpt":null,"comments":71,"topLevelComments":32,"maxDepth":5,"uniqueCommenters":41,"topComments":[{"id":8865,"by":"dhouston","postedAt":"2007-04-04T19:22:55.000Z","replies":1,"excerpt":"oh, and a mac port is coming :)"},{"id":8869,"by":"zaidf","postedAt":"2007-04-04T19:36:20.000Z","replies":2,"excerpt":"This has great potential! Only suggestion I would have is go slower on the demo. I know you lost me very early into it switching between windows. If you are looking for a wider audience than those who…"}],"discussion":"https://news.ycombinator.com/item?id=8863","degraded":false,"notChecked":["comments newer than the search index","deleted and dead comments (they are not in the tree)","…1 more"],"source":"Algolia HN Search (items endpoint)","sourceUrl":"https://hn.algolia.com/api","asOf":"2026-10-21T00:39:16.365Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-item"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-item"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-item"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-item"}}]}}},"/hn-search":{"get":{"operationId":"hn_search","summary":"Search Hacker News stories or comments by query with optional date range, sorted by relevance or date.","description":"Search Hacker News stories or comments by query with optional date range, sorted by relevance or date.","tags":["hackernews","search","stories","comments"],"parameters":[{"name":"query","in":"query","required":true,"description":"Search text, e.g. rust async","schema":{"type":"string"}},{"name":"tags","in":"query","required":false,"description":"story (default) or comment","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"First UTC day YYYY-MM-DD","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"Last UTC day YYYY-MM-DD (inclusive)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"relevance (default) or date (newest first)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 20 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","string"]},"kind":{"type":["null","string"]},"sort":{"type":["null","string"]},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"totalMatches":{"type":["null","number"]},"returned":{"type":["null","number"]},"results":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","number"]},"title":{"type":["null","string"]},"by":{"type":["null","string"]},"points":{"type":["null","number"]},"comments":{"type":["null","number"]},"domain":{"type":["null","string"]},"url":{"type":["null","string"]},"postedAt":{"type":["null","string"]},"discussion":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"RESULTS_FOUND","summary":"6256 story matches for \"rust\" between 2025-01-01 and 2025-12-31; showing 10 by relevance.","reasons":["Algolia's hit count can be approximate for broad queries."],"query":"rust","kind":"story","sort":"relevance","from":"2025-01-01","to":"2025-12-31","totalMatches":6256,"returned":10,"results":[{"id":46213585,"title":"Rust in the kernel is no longer experimental","by":"rascul","points":962,"comments":800,"domain":"lwn.net","url":"https://lwn.net/Articles/1049831/","postedAt":"2025-12-10T03:15:24Z","discussion":"https://news.ycombinator.com/item?id=46213585"},{"id":44357411,"title":"uv: An extremely fast Python package and project manager, written in Rust","by":"chirau","points":753,"comments":336,"domain":"github.com","url":"https://github.com/astral-sh/uv","postedAt":"2025-06-23T16:27:25Z","discussion":"https://news.ycombinator.com/item?id=44357411"}],"degraded":false,"notChecked":["items the index does not hold (very new, deleted or dead)","typo-tolerant matches beyond what the engine returns","…1 more"],"source":"Algolia HN Search","sourceUrl":"https://hn.algolia.com/api","asOf":"2026-10-21T00:39:18.038Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-search"}}]}}},"/hn-top":{"get":{"operationId":"hn_top","summary":"Current Hacker News top, new, best, ask or show stories with score, comment count, domain and age (up to 15).","description":"Current Hacker News top, new, best, ask or show stories with score, comment count, domain and age (up to 15).","tags":["hackernews","stories","top","news"],"parameters":[{"name":"list","in":"query","required":false,"description":"top (default), new, best, ask or show","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Stories 1 to 15 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"list":{"type":["null","string"]},"requested":{"type":["null","number"]},"returned":{"type":["null","number"]},"medianScore":{"type":["null","number"]},"medianComments":{"type":["null","number"]},"meanScore":{"type":["null","number"]},"topDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":["null","string"]},"count":{"type":["null","number"]}}}},"stories":{"type":["array","null"],"items":{"type":"object","properties":{"rank":{"type":["null","number"]},"id":{"type":["null","number"]},"title":{"type":["null","string"]},"by":{"type":["null","string"]},"score":{"type":["null","number"]},"comments":{"type":["null","number"]},"domain":{"type":["null","string"]},"url":{"type":["null","string"]},"type":{"type":["null","string"]},"textPost":{"type":["boolean","null"]},"postedAt":{"type":["null","string"]},"age":{"type":["null","string"]},"ageMinutes":{"type":["null","number"]},"discussion":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"STORIES_LISTED","summary":"10 top stories; highest score 2110 (\"DeepInfer: High-performance inference framework for DeepSeek models\"), median 245.5.","reasons":["Order is the source's topstories order."],"list":"top","requested":10,"returned":10,"medianScore":245.5,"medianComments":102.5,"meanScore":445.5,"topDomains":[{"domain":"github.com","count":3},{"domain":"blogs.lse.ac.uk","count":1}],"stories":[{"rank":1,"id":50170593,"title":"SimCity, but with Permits","by":"pcai","score":511,"comments":273,"domain":"permit.petercai.com","url":"https://permit.petercai.com/","type":"story","textPost":false,"postedAt":"2026-10-20T18:29:09.000Z","age":"6h","ageMinutes":370,"discussion":"https://news.ycombinator.com/item?id=50170593"},{"rank":2,"id":50173487,"title":"Feds suspect ransom negotiator ran ShinyHunters extortion site","by":"Bender","score":67,"comments":14,"domain":"krebsonsecurity.com","url":"https://krebsonsecurity.com/2026/10/feds-suspect-ransom-negotiator-ran-shinyhunters-extortion-site/","type":"story","textPost":false,"postedAt":"2026-10-20T22:21:05.000Z","age":"2h","ageMinutes":138,"discussion":"https://news.ycombinator.com/item?id=50173487"}],"degraded":false,"notChecked":["stories beyond the requested limit","flagged or dead stories that are hidden from the list","…1 more"],"source":"Hacker News (Firebase API and Algolia HN Search)","sourceUrl":"https://news.ycombinator.com","asOf":"2026-10-21T00:39:19.776Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-top"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-top"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-top"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-top"}}]}}},"/hn-trending-topics":{"get":{"operationId":"hn_trending_topics","summary":"Trending keywords across current Hacker News stories: terms ranked by how many titles use them, with example titles.","description":"Trending keywords across current Hacker News stories: terms ranked by how many titles use them, with example titles.","tags":["hackernews","trends","keywords","topics"],"parameters":[{"name":"list","in":"query","required":false,"description":"top (default), new, best, ask or show","schema":{"type":"string"}},{"name":"stories","in":"query","required":false,"description":"Stories to analyse 5 to 15 (default 15)","schema":{"type":"integer"}},{"name":"top","in":"query","required":false,"description":"Terms to return 1 to 20 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"list":{"type":["null","string"]},"titlesAnalysed":{"type":["null","number"]},"termsReturned":{"type":["null","number"]},"terms":{"type":["array","null"],"items":{"type":"object","properties":{"term":{"type":["null","string"]},"titles":{"type":["null","number"]},"share":{"type":["null","number"]},"totalScore":{"type":["null","number"]},"exampleTitles":{"type":["array","null"],"items":{"type":"string"}}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"TOPICS_RANKED","summary":"15 top titles analysed; top terms: systems (2), deepinfer (1), deepseek (1), framework (1), high-performance (1).","reasons":["A term counts once per title. Own stopword list removes common words and Show HN/Ask HN prefixes; pure numbers are ignored."],"list":"top","titlesAnalysed":15,"termsReturned":10,"terms":[{"term":"systems","titles":2,"share":0.13,"totalScore":122,"exampleTitles":["Academics have a duty to defend open knowledge systems like Wikipedia","Benchmarking Bot Detection Systems Against Modern AI Agents in 2026"]},{"term":"deepinfer","titles":1,"share":0.07,"totalScore":2110,"exampleTitles":["DeepInfer: High-performance inference framework for DeepSeek models"]}],"degraded":false,"notChecked":["stories beyond the sample","story text and comments (titles only)","…2 more"],"source":"Hacker News (Firebase API and Algolia HN Search)","sourceUrl":"https://news.ycombinator.com","asOf":"2026-10-21T00:39:21.231Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-trending-topics"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-trending-topics"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-trending-topics"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-trending-topics"}}]}}},"/hn-user":{"get":{"operationId":"hn_user","summary":"Hacker News user profile: karma, account age, submission count and recent story/comment activity with top story.","description":"Hacker News user profile: karma, account age, submission count and recent story/comment activity with top story.","tags":["hackernews","user","karma","profile"],"parameters":[{"name":"username","in":"query","required":true,"description":"Case-sensitive HN username, e.g. pg","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"username":{"type":["null","string"]},"karma":{"type":["null","number"]},"createdAt":{"type":["null","string"]},"accountAgeDays":{"type":["null","number"]},"karmaPerYear":{"type":["null","number"]},"submissions":{"type":["null","number"]},"about":{"type":["null","string"]},"recentActivity":{"type":["null","object"],"properties":{"sampled":{"type":["null","number"]},"stories":{"type":["null","number"]},"comments":{"type":["null","number"]},"storyPoints":{"type":["null","number"]},"avgStoryPoints":{"type":["null","number"]},"topStory":{"type":["null","object"],"properties":{"id":{"type":["null","number"]},"title":{"type":["null","string"]},"by":{"type":["null","string"]},"points":{"type":["null","number"]},"comments":{"type":["null","number"]},"domain":{"type":["null","string"]},"url":{"type":["null","string"]},"postedAt":{"type":["null","string"]},"discussion":{"type":["null","string"]}}},"lastActiveAt":{"type":["null","string"]},"topDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":["null","string"]},"count":{"type":["null","number"]}}}}}},"profile":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"USER_FOUND","summary":"pg: 157316 karma, account 7316 days old, 15565 submissions; latest 30 items: 2 stories, 28 comments.","reasons":[],"username":"pg","karma":157316,"createdAt":"2006-10-09T18:21:32.000Z","accountAgeDays":7316,"karmaPerYear":7854,"submissions":15565,"about":"Bug fixer.","recentActivity":{"sampled":30,"stories":2,"comments":28,"storyPoints":516,"avgStoryPoints":258,"topStory":{"id":37278345,"title":"If you're interested in eye-tracking, I'm interested in funding you","by":"pg","points":374,"comments":209,"domain":"twitter.com","url":"https://twitter.com/paulg/status/1695596853864321055","postedAt":"2023-08-27T00:51:13Z","discussion":"https://news.ycombinator.com/item?id=37278345"},"lastActiveAt":"2024-03-11T12:57:11Z","topDomains":[{"domain":"thesocialradars.com","count":1},{"domain":"twitter.com","count":1}]},"profile":"https://news.ycombinator.com/user?id=pg","degraded":false,"notChecked":["activity older than the latest 30 items","private or deleted items","…1 more"],"source":"Hacker News (Firebase API and Algolia HN Search)","sourceUrl":"https://news.ycombinator.com","asOf":"2026-10-21T00:39:22.981Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-user"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-user"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-user"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://hacker-news.x402tookit.com/hn-user"}}]}}}}}