{"uid":"cap_DZZUq_nZB2Jh-fSLCN4bX","slug":"foundry-hacker-news-top-stories-cc7d7444","name":"Foundry Hacker News Top Stories","description":"Hacker News top stories right now: title, link, points and comments. Input: how many, 1 to 10.","url":"https://minty-sprout.onrender.com/v1/hacker-news-top?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","maxLength":8000,"description":"Number of stories, 1 to 10"}}},"responseSchema":{"type":"json","example":{"source":"Hacker News API","stories":[{"by":"karpathy","url":"https://karpathy.bearblog.dev/hacker-tube/","title":"HackerTube: YouTube built from videos recommended by HN","hn_url":"https://news.ycombinator.com/item?id=50319510","points":514,"comments":193},{"by":"ecares","url":"https://www.smithsonianmag.com/science-nature/italian-farmer-found-unknown-seeds-attic-with-nothing-lose-planted-them-result-biblical-180989644/","title":"An Italian Farmer Found Some Unknown Seeds in His Attic and Planted Them","hn_url":"https://news.ycombinator.com/item?id=50320963","points":41,"comments":8},{"by":"oger","url":"https://atlasum.net/blog/cve-2026-98432-linux-ipv4-tcp-uaf","title":"TCP Use-After-Free: CVE-2026-98432 / CVSS 9.8","hn_url":"https://news.ycombinator.com/item?id=50319143","points":265,"comments":132}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7H0jFPcz8qdIso0hX0vxq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current top Hacker News stories (1–10) with title, link, points, and comment count","exampleAgentPrompt":"What are the top 5 stories on Hacker News right now? Give me the titles, links, and how many points each one has.","exampleUseCases":[{"title":"Morning tech briefing for developers","prompt":"Pull the top 10 Hacker News stories right now so I can scan what's trending in tech this morning."},{"title":"Spotting viral links for a newsletter","prompt":"Grab the 5 highest-ranked Hacker News posts right now — I want the titles and URLs to consider for my weekly newsletter."},{"title":"Tracking a specific story's traction","prompt":"Get me the top 3 stories on Hacker News at this moment, including points and comment counts, so I can see which topics are generating the most discussion."}],"resultDescription":"A JSON object with a source field ('Hacker News API') and a stories array. Each story object contains: title, url (link to the article), hn_url (link to HN discussion thread), by (author username), points (upvote score), and comments (comment count). Stories are ordered by current HN ranking.","failureModes":["Invalid count (outside 1–10 range) may return an error or default value","Hacker News API downtime causes upstream failure","Network timeout from the Render hosting environment","Stale data if HN API caching is in effect"],"whenToPreferThis":"Use this endpoint when you need real-time Hacker News front-page data — titles, links, scores, and discussion counts — without scraping or requiring an HN API key yourself. Prefer it over general web search when the task is specifically about what is trending on Hacker News, since it returns structured data directly from the HN API rather than raw HTML. It is pay-per-call with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:55:42.553Z","isFirstParty":false,"canonicalSlug":"foundry-hacker-news-top-stories-cc7d7444"}