{"uid":"cap_pcd3EMXW7aCut-m9B7X6X","slug":"hacker-news-item-summarizer-2819f5bf","name":"Hacker News Item Summarizer","description":"Summarise a Hacker News item and its comment tree: comment count, depth, authors and top comments, truncated.","url":"https://hacker-news.x402tookit.com/hn-item?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":["id"],"properties":{"id":{"type":"integer","description":"Item id, e.g. 8863 (the number in news.ycombinator.com/item?id=)"},"top":{"type":"integer","description":"Top-level comments to excerpt, 0 to 10 (default 5)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"by":{"type":["null","string"]},"id":{"type":["null","number"]},"url":{"type":["null","string"]},"asOf":{"type":["null","string"]},"type":{"type":["null","string"]},"title":{"type":["null","string"]},"domain":{"type":["null","string"]},"points":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"comments":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"maxDepth":{"type":["null","number"]},"postedAt":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"discussion":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"textExcerpt":{},"topComments":{"type":["array","null"],"items":{"type":"object","properties":{"by":{"type":["null","string"]},"id":{"type":["null","number"]},"excerpt":{"type":["null","string"]},"replies":{"type":["null","number"]},"postedAt":{"type":["null","string"]}}}},"topLevelComments":{"type":["null","number"]},"uniqueCommenters":{"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_itjk8Ttf1JRJC5HQxk4T2","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 and summarizes a Hacker News item (story, Ask HN, etc.) with its comment tree: comment count, depth, unique authors, and top excerpted comments.","exampleAgentPrompt":"Can you summarize Hacker News item 8863 for me, including the top 5 comments and a sense of how deep the discussion goes?","exampleUseCases":[{"title":"Digest a viral HN thread","prompt":"There's a big discussion happening on Hacker News — item ID 37592013. Can you summarize the story and pull out the top 7 comments so I can quickly understand what the community is saying without reading everything?"},{"title":"Research community reaction to a product launch","prompt":"Our product just got submitted to Hacker News as item 39041234. Can you give me a summary of the post and show me the most-upvoted comments so I can gauge how developers are reacting?"},{"title":"Monitor depth of a technical debate","prompt":"I want to know how deep and active the conversation is on Hacker News item 40123456 — how many comments are there, how many unique people chimed in, and what are the top 3 comments saying?"}],"resultDescription":"Returns a structured summary of the HN item including: title, URL, domain, author, points, post timestamp, total comment count, top-level comment count, unique commenter count, maximum comment tree depth, an AI-generated summary of the story, a discussion summary, and an array of top-comment excerpts (each with author, timestamp, reply count, and text excerpt). May include a degraded flag if data retrieval was partial.","failureModes":["Invalid or non-existent item ID returns null or error fields","Deleted or dead items may return minimal metadata with empty comment data","Very large comment trees may be truncated, indicated by the degraded flag","Payment failure (x402) if USDC balance is insufficient","Rate limiting if too many requests are made in quick succession","The 'top' parameter outside 0-10 range may be rejected or clamped"],"whenToPreferThis":"Use this endpoint when you need a summarized digest of a specific Hacker News story and its discussion — identified by item ID — rather than searching for stories or browsing feeds. Ideal when you already have a HN item ID (from a URL like news.ycombinator.com/item?id=8863) and want both story metadata and community sentiment without reading the full thread. Prefer this over the search or feed endpoints when the target item is already known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:54.908Z","isFirstParty":false,"canonicalSlug":"hacker-news-item-summarizer-2819f5bf"}