{"uid":"cap_8YVe7wQXmlfH_5EdlgLcn","slug":"hacker-news-top-new-best-ask-show-stories-feed-181397d3","name":"Hacker News Top/New/Best/Ask/Show Stories Feed","description":"Current Hacker News top, new, best, ask or show stories with score, comment count, domain and age (up to 15).","url":"https://hacker-news.x402tookit.com/hn-top?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"list":{"type":"string","description":"top (default), new, best, ask or show"},"limit":{"type":"integer","description":"Stories 1 to 15 (default 10)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"list":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"stories":{"type":["array","null"],"items":{"type":"object","properties":{"by":{"type":["null","string"]},"id":{"type":["null","number"]},"age":{"type":["null","string"]},"url":{"type":["null","string"]},"rank":{"type":["null","number"]},"type":{"type":["null","string"]},"score":{"type":["null","number"]},"title":{"type":["null","string"]},"domain":{"type":["null","string"]},"comments":{"type":["null","number"]},"postedAt":{"type":["null","string"]},"textPost":{"type":["boolean","null"]},"ageMinutes":{"type":["null","number"]},"discussion":{"type":["null","string"]}}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"meanScore":{"type":["null","number"]},"requested":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"topDomains":{"type":["array","null"],"items":{"type":"object","properties":{"count":{"type":["null","number"]},"domain":{"type":["null","string"]}}}},"medianScore":{"type":["null","number"]},"medianComments":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fUZGJPMkKLQT78MlRjnpp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches up to 15 current Hacker News stories from a selected list (top, new, best, ask, or show) with score, comment count, domain, and age metadata.","exampleAgentPrompt":"What are the top 15 Hacker News stories right now? Show me the front page — I want the titles, scores, comment counts, and how old each post is.","exampleUseCases":[{"title":"Morning tech news briefing","prompt":"Pull the top 10 Hacker News stories from right now and give me a quick rundown of the titles, scores, and domains — I want to catch up on what the tech world is talking about this morning."},{"title":"Monitor Ask HN for community questions","prompt":"Fetch the latest Ask HN posts from Hacker News — up to 15 of them — so I can see what questions the developer community is actively discussing right now."},{"title":"Discover trending Show HN projects","prompt":"Show me the current Show HN feed on Hacker News, up to 15 stories, so I can see what new projects and tools developers are launching today."}],"resultDescription":"Returns a list of up to 15 stories with rank, title, URL, domain, author, score, comment count, age in minutes, posted timestamp, and a text-post flag. Also includes aggregate stats: mean and median score, mean and median comment count, top domains by story count, the list type requested, total stories returned, and a timestamp for when the data was fetched.","failureModes":["Invalid list type value returns an error or defaults to top","Limit outside 1-15 range may be clamped or rejected","Hacker News API downtime causes degraded or empty response (degraded flag set to true)","Network timeout returns no stories","Requesting more than 15 stories is not supported"],"whenToPreferThis":"Choose this endpoint when you need a real-time snapshot of the current Hacker News front page or one of its named feeds (top, new, best, ask, show) with rich per-story metadata including scores and comment counts. Prefer it over the search endpoint when you want a ranked feed rather than keyword-filtered results, and over the date-based endpoint when you need live current stories rather than historical archives.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:12.066Z","isFirstParty":false,"canonicalSlug":"hacker-news-top-new-best-ask-show-stories-feed-181397d3"}