{"uid":"cap_en2uOTtnmvtuIA1Xg68A7","slug":"hacker-news-comments-threads-9ddff154","name":"Hacker News Comments & Threads","description":"Hacker News Comments & Threads: one Hacker News story or comment by id or news.ycombinator.com URL with its direct replies (up to 8 per call, next_cursor for more), deleted and dead replies skipped. Per item the text as plain text, author, score, reply count, parent and time in the shared social schema. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/hackernews/thread?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":"string","maxLength":200,"description":"The story or comment: a Hacker News item id (a positive whole number) or a news.ycombinator.com/item?id= URL."},"limit":{"type":"string","pattern":"^[0-9]{1,4}$","description":"Direct replies wanted, 1-50 (default 10); one call returns at most 8, next_cursor pages through the rest."},"cursor":{"type":"string","maxLength":6,"description":"next_cursor of the previous page (a reply offset)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"40000001","url":"https://news.ycombinator.com/item?id=40000001","lang":null,"text":null,"type":"post","title":"Show HN: Synthwidget, a synthetic widget","author":{"handle":"synth_hn_user1","verified":null,"followers":null,"display_name":null},"metrics":{"likes":128,"views":null,"replies":47,"reposts":null},"link_url":"https://example.invalid/synthwidget","platform":"hackernews","parent_id":null,"created_at":"2026-10-13T14:00:00.000Z","media_urls":[]},{"id":"40000011","url":"https://news.ycombinator.com/item?id=40000011","lang":null,"text":"Looks useful. How does it compare to the old one?","type":"comment","author":{"handle":"synth_hn_user4","verified":null,"followers":null,"display_name":null},"metrics":{"likes":null,"views":null,"replies":1,"reposts":null},"platform":"hackernews","parent_id":"40000001","created_at":"2026-10-13T14:10:00.000Z","media_urls":[]}],"query":{"id":"40000001","limit":10,"cursor":null},"source":"public data via the Hacker News API (Algolia search and Firebase); not affiliated with Y Combinator","complete":true,"platform":"hackernews","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wNpXC-y1MGrrKQTvgFAKO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single Hacker News story or comment by ID or URL along with its direct replies, skipping deleted and dead entries, with cursor-based pagination.","exampleAgentPrompt":"Pull up the Hacker News thread for item ID 40000001 and show me the first 10 direct replies — skip any deleted or dead ones.","exampleUseCases":[{"title":"Monitor HN reactions to a product launch","prompt":"Fetch the Hacker News thread for news.ycombinator.com/item?id=40000001 and give me a summary of what the top commenters are saying about the launch."},{"title":"Paginate through a large HN discussion","prompt":"Get the next page of replies for Hacker News item 40000001 — use cursor '8' to continue from where we left off and give me up to 8 more comments."},{"title":"Research sentiment on a specific HN comment","prompt":"Retrieve the Hacker News comment with ID 40000011 and show me its direct replies, the author, score, and reply count so I can see how people reacted to it."}],"resultDescription":"Returns a JSON object containing the requested story or comment item plus up to 8 direct replies (non-deleted, non-dead), each with ID, URL, plain-text content, type (post or comment), author handle, likes/replies metrics, parent ID, platform, and creation timestamp. Also includes a next_cursor for fetching additional replies, a complete flag, request ID, and source/disclaimer fields.","failureModes":["Invalid or malformed item ID returns a bad-input response (not charged)","Item ID not found on Hacker News returns a not-found response (not charged)","No matching replies returns an empty items array with complete:true","Cursor value out of range may return an empty page","Network timeout or upstream Firebase/Algolia outage may cause transient errors"],"whenToPreferThis":"Choose this endpoint when you need the full discussion thread for a specific Hacker News item — known by ID or URL — including paginated direct replies with metadata like score and reply count. It is ideal for retrieving structured comment data on a particular submission rather than searching across HN. Prefer Hacker News Search & Stories for keyword discovery and this endpoint for deep-diving into a known thread.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:38.888Z","isFirstParty":false,"canonicalSlug":"hacker-news-comments-threads-9ddff154"}