{"uid":"cap_PoVpa3E2EKFD36AQqJPEd","slug":"hackernews-x402-vercel-app-e88c1ebf","name":"Hacker News Top Stories Feed","description":"Hacker News top stories feed. Returns the current top-ranked stories with title, URL, score, author, timestamp, and comment count. Tech industry's premier social news aggregator.","url":"https://hackernews-x402.vercel.app/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":{"limit":{"type":"string","description":"Number of stories to return (default 10, max 30)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"feed":{"type":"string"},"count":{"type":"number"},"stories":{"type":"array"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":"5"}}},"response":{"feed":"topstories","count":5,"stories":[{"by":"rvz","id":48385906,"url":"https://blog.google/innovation-and-ai/technology/developers-tools/introducing-gemma-4-12b/","time":"2026-06-03T16:04:42.000Z","type":"story","score":350,"title":"Gemma 4 12B: A unified, encoder-free multimodal model","descendants":127},{"by":"jmsflknr","id":48387144,"url":"https://radar.cloudflare.com/traffic#bot-vs-human","time":"2026-06-03T17:43:00.000Z","type":"story","score":74,"title":"Bots have now passed human traffic online for the first time","descendants":28},{"by":"Tomte","id":48384355,"url":"https://burntsushi.net/encephalitis/","time":"2026-06-03T14:10:06.000Z","type":"story","score":129,"title":"I was recently diagnosed with anti-NMDA receptor encephalitis","descendants":25},{"by":"volemo","id":48385965,"url":"https://www.espressif.com/en/products/socs/esp32-s31","time":"2026-06-03T16:10:25.000Z","type":"story","score":144,"title":"ESP32-S31","descendants":69},{"by":"pentagrama","id":48384482,"url":"https://www.blackmagicdesign.com/products/davinciresolve/whatsnew","time":"2026-06-03T14:18:39.000Z","type":"story","score":232,"title":"DaVinci Resolve 21","descendants":126}]}},"exampleRequest":{"limit":"5"},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.83","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZdN4GJShEuxJgyt42Gl5N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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-ranked Hacker News stories with title, URL, score, author, timestamp, and comment count","exampleAgentPrompt":"What are the top 10 stories on Hacker News right now — give me the titles, scores, and links?","exampleUseCases":[{"title":"Daily tech briefing for engineering teams","prompt":"Pull the top Hacker News stories this morning and give me a quick summary of what engineers are talking about — focus on the ones with the most engagement."},{"title":"Monitor trending discussions in your industry","prompt":"Show me what's trending on Hacker News today that relates to AI and machine learning — I want to see the titles, scores, and how many people are discussing each one."},{"title":"Find breaking tech news for newsletters","prompt":"What are the highest-scoring Hacker News posts right now? I need the top ones with their links so I can feature them in our weekly tech digest."}],"resultDescription":"A JSON object containing the feed name ('topstories'), count of stories returned, and an array of story objects each with fields: id, title, url, score, author (by), timestamp (time), story type, and comment count (descendants).","failureModes":["Exceeds max limit of 30 stories — returns error or truncates","Hacker News API upstream unavailability — service may return 502 or timeout","Invalid query parameter type for limit — may return 400 or default behavior","Payment not provided or insufficient — returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need the current top-ranked stories on Hacker News specifically, rather than newest or Ask HN posts. Ideal for surfacing what the tech community is currently upvoting most. Prefer this over the newest stories endpoint when you want quality/popularity signal rather than recency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":6,"lastUsedAt":"2026-06-29T20:16:30.757Z","lastSuccessfullyRanAt":"2026-06-29T20:16:30.757Z","lastHealthCheckAt":"2026-10-12T16:28:42.261Z","isFirstParty":false,"canonicalSlug":"hackernews-x402-vercel-app-e88c1ebf"}