{"uid":"cap_6Ois75Io2yz78HW_7Wrcu","slug":"hacker-news-stories-5d112b1a","name":"Hacker News Stories","description":"Hacker News stories by keyword (by relevance or newest) or the current front page: title, link, points, comment count, author, time and discussion URL. Use to see what developers are discussing about a topic.","url":"https://bess-x402.onrender.com/v1/news/hackernews?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Search words (omit for front page)"},"sort":{"type":"string","description":"relevance, date or front_page"},"limit":{"type":"integer","description":"Maximum number of results (1-100)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.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_aiVe8lG8NFwp_xEhduvkE","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":"Fetches Hacker News stories by keyword search (sorted by relevance or date) or the current front page, returning title, link, points, comment count, author, timestamp, and discussion URL.","exampleAgentPrompt":"Can you search Hacker News for discussions about WebAssembly, sorted by relevance, and show me the top 10 results with their points and comment counts?","exampleUseCases":[{"title":"Research developer sentiment on a topic","prompt":"Search Hacker News for the latest discussions about Rust programming language, sorted by date, and give me the top 20 results so I can see what the dev community is saying recently."},{"title":"Monitor front page for tech trends","prompt":"Pull the current Hacker News front page for me — I want to see what's trending in tech right now, with titles, points, and how many comments each story has."},{"title":"Competitive research on a startup","prompt":"Find Hacker News stories mentioning Notion, sorted by relevance, and return up to 15 results — I want to see what developers think about them."}],"resultDescription":"Returns a list of Hacker News stories, each containing: story title, link to the original article, points (upvotes), number of comments, author username, posting timestamp, and the HN discussion URL. Results are ordered by the chosen sort (relevance, date, or front page ranking).","failureModes":["Missing required 'type' or 'method' fields in input returns a validation error","Invalid sort value (not 'relevance', 'date', or 'front_page') may return an error or unexpected results","Limit outside 1-100 range may be clamped or rejected","Empty query with sort set to 'relevance' or 'date' (instead of 'front_page') may return no results or an error","Render.com cold start may add latency on first request after inactivity"],"whenToPreferThis":"Choose this endpoint when you need to surface developer community discussions, sentiment, or news from Hacker News specifically — ideal for tech/startup research, trend monitoring, and gauging developer opinion. Prefer this over generic web search when the audience is explicitly the developer/hacker community and you want structured metadata (points, comments, author) alongside links.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:45:17.156Z","isFirstParty":false,"canonicalSlug":"hacker-news-stories-5d112b1a"}