{"uid":"cap_X_5A5hUphJi8Tk0Dujj74","slug":"hacker-news-story-search-by-query-01ee6fb4","name":"Hacker News Story Search by Query","description":"Hacker News stories matching a query (?q=rust) ranked by relevance, with points and comment counts. Returns JSON.","url":"https://clonecho.builda.company/x402/hn-search","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6T-Y-Vo-qHR1uW-t7Quj0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Hacker News stories matching a text query, returning results ranked by relevance with points and comment counts.","exampleAgentPrompt":"Search Hacker News for stories about Rust and show me the top results with their upvote counts and comment counts.","exampleUseCases":null,"resultDescription":"A JSON array of Hacker News stories matching the query, each including the story title, URL, author, points (upvotes), number of comments, and relevance-ranked position.","failureModes":["Empty result set if query matches no HN stories","Missing or malformed ?q= parameter may return an error or empty results","Payment failure (402) if USDC balance is insufficient","Upstream HN search API downtime causing fetch errors","Rate limiting if called excessively in a short window"],"whenToPreferThis":"Use this endpoint when you need to search Hacker News specifically for community-ranked tech stories, developer discussions, or startup news by keyword — particularly when relevance ranking and engagement signals (points, comments) matter. Prefer this over generic web search when the goal is specifically to gauge what the Hacker News developer community thinks about a topic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:21:59.140Z","isFirstParty":false}