{"uid":"cap_g0il4Hz_A3wVb1QG7sqFw","slug":"saylor-innovations-data-desk-hacker-news-front-page-8eaa060f","name":"Saylor Innovations Data Desk – Hacker News Front Page","description":"Hacker News front page - current top, new, Ask HN or Show HN stories with rank, points, comments and links","url":"https://saylorinnovations.com/api/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","properties":{"kind":{"type":"string","description":"optional top (default), new, ask or show"},"limit":{"type":"string","description":"optional 1-30, default 15"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["kind","stories"],"properties":{"kind":{"type":"string","description":"Kind of record"},"source":{"type":["string","null"],"description":"Data source the values come from"},"stories":{"type":"array","items":{"type":"object","properties":{"url":{"type":["string","null"],"description":"Canonical URL"},"rank":{"type":"number","description":"Rank, 1 is highest"},"title":{"type":["string","null"],"description":"Title"},"author":{"description":"Author name"},"hn_url":{"type":"string","description":"Hn URL"},"points":{"type":["number","null"]},"comments":{"type":["number","null"]},"created_at":{"description":"Created at (UTC unless a time zone is given)"}}}},"returned":{"type":"number","description":"Number of items in this response"},"checked_at":{"type":["string","null"],"description":"Time the check was run (UTC)"}}}}}}},"responseSchema":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_AvlOzUtUtsg_S6gv0GKiz","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 current Hacker News front page stories (top, new, Ask HN, or Show HN) with rank, points, comment count, and links","exampleAgentPrompt":"What are the top 20 stories on Hacker News right now? Show me the titles, points, and comment counts.","exampleUseCases":[{"title":"Morning tech news briefing","prompt":"Pull the top 15 Hacker News stories this morning so I can see what's trending in the tech world — give me titles, points, and links."},{"title":"Monitoring Ask HN discussions","prompt":"Fetch the current Ask HN posts from Hacker News — I want to see the top 10 questions the community is discussing right now, with their point counts and number of comments."},{"title":"Tracking new Show HN launches","prompt":"Get me the latest Show HN submissions from Hacker News, up to 20 of them, so I can see what products and projects people are showing off today."}],"resultDescription":"A JSON object containing the story kind requested, the data source, a checked_at timestamp, the number of stories returned, and an array of story objects each with rank, title, URL, HN discussion URL, author, points, comment count, and created_at timestamp.","failureModes":["Invalid 'kind' parameter value (not top/new/ask/show) may return an error or default behavior","Limit outside 1-30 range may be clamped or rejected","Hacker News API downtime may result in stale or unavailable data","Payment failure (x402) blocks access if USDC balance insufficient"],"whenToPreferThis":"Use this endpoint when you need structured, ranked Hacker News front page data including points and comment counts in a single call, especially when you want to filter by story type (top, new, Ask HN, Show HN) and control result count. Prefer this over scraping HN directly or using the raw HN Firebase API when you want a clean, normalized JSON response with rank ordering already applied.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T18:51:05.233Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-hacker-news-front-page-8eaa060f"}