{"uid":"cap_u2nywZK00Jr9wihDmhczs","slug":"hacker-news-trending-stories-api-7f38fe91","name":"Hacker News Trending Stories API","description":"Top Hacker News stories right now: title, url, points, comments. Fresh front-page data, no API key needed.","url":"https://gen-copied-sampling-calibration.trycloudflare.com/hn/trending","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":10,"maximum":30,"minimum":1,"description":"Number of stories to return (1-30)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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":"down","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_C81GUgJRtm2NjNnAtQjCW","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":"Returns the current top Hacker News front-page stories with title, URL, points, and comment count","exampleAgentPrompt":"What are the top 15 stories on Hacker News right now? Give me the titles, links, points, and comment counts.","exampleUseCases":[{"title":"Daily tech news briefing","prompt":"Pull the top 20 Hacker News stories right now so I can skim the headlines and pick a few interesting links to read this morning."},{"title":"Trending topics for content research","prompt":"What are the top 30 things people are talking about on Hacker News today? I want titles, points, and comment counts so I can see which topics are generating the most discussion."},{"title":"Automated HN digest for a newsletter","prompt":"Grab the current top 10 Hacker News front-page stories — title, URL, and score — so I can include them in today's tech newsletter."}],"resultDescription":"A list of up to 30 Hacker News front-page stories, each containing the story title, source URL, current upvote point score, and number of comments. Data reflects the live HN front page at time of request.","failureModes":["Hacker News upstream unavailable — returns error or stale data","limit parameter out of range (must be 1–30) returns validation error","Cloudflare tunnel temporarily offline — connection refused or 5xx error","Rate limiting if called too frequently"],"whenToPreferThis":"Choose this endpoint when you need no-auth, instant access to live Hacker News front-page data. It is ideal for tech news digests, trend monitoring, or content research where Hacker News is specifically the desired source. No API key is required, making it trivially easy to call. Prefer alternatives if you need historical HN data, search across all HN posts, or real-time comment threads.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:27:00.228Z","isFirstParty":false}