{"uid":"cap_aZPxe1H68AfTxm7_D06bM","slug":"x402-hacker-news-search-front-page-5458da5e","name":"x402 Hacker News Search & Front Page","description":"Use to find what developers and the tech industry are discussing about a topic, or to get today's top tech stories. Full-text Hacker News search (or the front page when no query), filterable by age, points and story type, up to 50 stories with points, comment counts and links. Not charged if nothing matches.","url":"https://x402-tools-production-2755.up.railway.app/tools/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"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Search text. Omit to get the current front page"},"kind":{"enum":["story","show_hn","ask_hn","front_page"],"type":"string","description":"Default story with q, front_page without"},"sort":{"enum":["relevance","date"],"type":"string","description":"Default relevance (popularity when q is omitted)"},"limit":{"type":"string","description":"1-50, default 20"},"since":{"type":"string","description":"Only stories newer than this, e.g. 24h or 7d"},"min_points":{"type":"string","description":"Minimum HN points"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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_YhUzFYGyjKP-xLYb-JSyJ","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":"Full-text search of Hacker News stories or fetch the current front page, with filters for age, points, and story type, returning up to 50 stories with metadata.","exampleAgentPrompt":"What are developers on Hacker News saying about WebAssembly? Show me up to 20 stories from the last 7 days with at least 50 points.","exampleUseCases":[{"title":"Tech industry pulse on a new topic","prompt":"Search Hacker News for what people are saying about Model Context Protocol — grab up to 30 stories sorted by relevance, from the last 30 days, with at least 20 points."},{"title":"Daily front page briefing","prompt":"Pull up today's Hacker News front page and give me the top 10 stories so I can see what's trending in tech right now."},{"title":"Show HN project discovery","prompt":"Find recent Show HN posts about developer tools from the last 7 days, sorted by date, limit 20 — I want to see what builders have been shipping."}],"resultDescription":"Returns a list of up to 50 Hacker News stories, each including the title, URL, HN post link, points score, number of comments, author, and publication timestamp. If no stories match the query filters, the call is not charged.","failureModes":["No matching stories — returns empty results and no charge is incurred","Invalid 'since' format (e.g. '2weeks' instead of '14d') may return an error or unexpected results","Exceeding limit of 50 stories — clamped or returns an error","Invalid 'kind' enum value returns a validation error","HN search backend downtime causes service unavailability"],"whenToPreferThis":"Choose this endpoint when you need real-time insight into what the developer and tech community is actively discussing — especially for trending topics, community sentiment, or curated tech news. It is superior to generic web search for Hacker News-specific content because it supports structured filters (time range, point threshold, story type) and returns clean structured story metadata. Prefer it over scraping HN directly for reliability and structured output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:40:07.971Z","isFirstParty":false,"canonicalSlug":"x402-hacker-news-search-front-page-5458da5e"}