{"uid":"cap_FYMI7AqTSAhoI_gCV-Xwh","slug":"hacker-news-live-data-fetcher-a194a50d","name":"Hacker News Live Data Fetcher","description":"This tool reads live information from Hacker News, a popular website where people share and discuss technology news. You can either ask for a current list of stories (like the Top, New, Best, Ask, Show, or Job lists) or ask for every story, job posting, and poll that was posted on one specific calendar day in the past. You can also choose to pull in the discussion comments underneath each story, including nested replies several levels deep.","url":"https://hackernews-data.underscoredone.com/fetch","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","description":"A calendar day in YYYY-MM-DD format (UTC). If given, the tool switches to scanning that whole day instead of using a category."},"limit":{"type":"integer","description":"The largest number of results to return. Default is 30, maximum is 200."},"category":{"type":"string","description":"Which current list to pull from: top, new, best, ask, show, or job. Ignored if a date is given."},"page_token":{"type":"integer","description":"A resume point from a previous date-scan response, used to continue scanning the same day where it left off."},"reply_depth":{"type":"integer","description":"How many levels of nested replies to fetch below each comment. Default 0, maximum 5."},"comment_limit":{"type":"integer","description":"How many top-level comments to fetch per story in category mode. Default 10, maximum 100, 0 means none."},"replies_per_comment":{"type":"integer","description":"The largest number of replies fetched per comment at each level. Default 5, maximum 20."}}},"responseSchema":{"type":"json","example":{"date":"","mode":"get_stories","count":5,"results":[{"id":48753715,"url":"https://zcode.z.ai/en","title":"ZCode – Harness for GLM-5.2","author":"chvid","points":234,"category":"top","comments":[{"id":48752128,"body":"I'm somewhat surprised that this is not open source...","author":"seizethecheese","replies":[],"posted_at":1782935074,"reply_count":9}],"item_type":"story","posted_at":1782943416,"comment_count":223}],"scanned":"","category":"top","api_version":"1.0.0","range_complete":"","next_page_token":""}},"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_2uWMtzgIjphUwJl3ry5Uo","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 live Hacker News story lists by category or retrieves all stories, jobs, and polls posted on a specific date, with optional nested comment threads.","exampleAgentPrompt":"Can you pull the top 50 Hacker News stories from the 'best' list, including up to 20 comments per story and 2 levels of nested replies?","exampleUseCases":[{"title":"Daily HN digest with comments","prompt":"Can you grab all the Hacker News stories and job postings from last Tuesday and include the top comment threads for each one, going about 3 levels deep on the replies?"},{"title":"Live top stories briefing","prompt":"What are the current top 20 Hacker News stories right now? I'd love to see the titles, scores, and authors — no need for comments this time."},{"title":"Find HN job board listings","prompt":"Can you pull all the job postings from the Hacker News job board today so I can see what companies are hiring and what roles they're looking for?"}],"resultDescription":"Returns a list of Hacker News stories, job postings, or polls matching the requested category or date, each with metadata (title, URL, score, author, timestamp) and optionally populated comment threads nested up to the specified reply depth. Date-mode responses include a page_token for continuing pagination across the same day.","failureModes":["Invalid date format (not YYYY-MM-DD) returns an error","Category value not in allowed enum (top/new/best/ask/show/job) causes failure","reply_depth exceeding maximum of 5 is rejected","limit exceeding 200 is capped or rejected","Stale or invalid page_token causes pagination error","HN API downtime results in upstream timeout or empty response","No stories found for a given date returns empty result set"],"whenToPreferThis":"Use this endpoint when you need live or historical Hacker News content — either real-time category feeds (top, new, best, ask, show, job) or a full day's worth of posts — especially when you also need threaded comment data. Prefer this over scraping HN directly or using the raw Firebase HN API when you want a managed, paginated interface with nested reply support and per-call x402 micropayment pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:26.318Z","isFirstParty":false}