{"uid":"cap_uMQXn-g-BvJyra8iZSutw","slug":"hacker-news-top-stories-feed-0435306f","name":"Hacker News Top Stories Feed","description":"Current top N Hacker News stories (title, url, score, author, comment count) — tech/startup news ranking. Optional parameter: ?limit=<n> (1-50, default 20).","url":"https://x402-seller-0ay3.onrender.com/api/hn/top","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":[],"properties":{"limit":{"type":"integer","description":"Number of stories to return (1-50, default 20)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":20,"source":"https://hacker-news.firebaseio.com","stories":[{"by":"someuser","id":123456,"url":"https://example.com","score":250,"title":"Show HN: ...","comments":80}],"fetched_at":"2026-09-01T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gifWUDkfrPYwyqHStfgg1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current top N Hacker News stories with title, URL, score, author, and comment count","exampleAgentPrompt":"What are the top 10 stories on Hacker News right now? Give me the titles, scores, and links.","exampleUseCases":[{"title":"Morning tech briefing digest","prompt":"Pull the top 20 Hacker News stories this morning so I can skim the titles and scores before my standup."},{"title":"Startup trend monitoring","prompt":"What are the 5 highest-scoring Hacker News posts right now? I want to see what topics the startup community is buzzing about today."},{"title":"Developer community pulse check","prompt":"Grab the top 15 Hacker News stories for me — I need the titles, URLs, and comment counts to see what's getting the most discussion in the dev world right now."}],"resultDescription":"A JSON object containing a count of stories returned, the source URL (Hacker News Firebase API), a fetch timestamp, and an array of story objects each with fields: id, title, url, score, author (by), and comments count.","failureModes":["limit parameter out of range (not 1-50) may return an error or be clamped","Hacker News Firebase API unavailability causes upstream fetch failure","Cold start latency on Render free tier may cause timeout on first request","Payment failure (x402) blocks the request before it reaches the API logic"],"whenToPreferThis":"Use this endpoint when you need a real-time snapshot of the current Hacker News front page with structured data (scores, authors, comment counts) rather than scraping HN yourself. Prefer this over generic web scrapers for HN because it returns clean, pre-parsed JSON with all relevant fields. Best for monitoring, digest generation, or any agent workflow that needs to react to trending tech/startup content without maintaining its own HN poller.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:46:16.317Z","isFirstParty":false}