{"uid":"cap_FxgqtgYaJjYeRWysz86ZE","slug":"hacker-news-search-stories-or-comments-by-relevance-or-recency-2edc65fb","name":"Hacker News Search: Stories or Comments by Relevance or Recency","description":"Hacker News search: stories or comments, by relevance or recency — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/research/hn-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"q":{"type":"string","description":"required"},"sort":{"enum":["relevance","recent"],"type":"string","description":"optional: relevance (default) | recent"},"type":{"enum":["story","comment","any"],"type":"string","description":"optional: story (default) | comment | any"},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"optional: max rows (default 10, max 50)"},"since_days":{"type":"integer","maximum":3650,"minimum":1,"description":"optional 1-3650"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"hn-search","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.002,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"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_vhdU6EmDLaoj6ZFtG3XF1","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":"Searches Hacker News for stories or comments matching a query, sortable by relevance or recency, with optional type and date filters.","exampleAgentPrompt":"Search Hacker News for the most recent stories about 'WebAssembly' from the last 30 days — give me up to 20 results sorted by recency.","exampleUseCases":[{"title":"Track competitor mentions on HN","prompt":"Search Hacker News for any stories or comments mentioning 'Vercel' from the past 14 days, sorted by most recent, and give me up to 30 results."},{"title":"Find top HN discussions on a framework","prompt":"What are the most relevant Hacker News stories about 'Rust async' — show me up to 15 results sorted by relevance."},{"title":"Monitor HN sentiment after a product launch","prompt":"Pull Hacker News comments mentioning 'Arc browser' from the last 7 days, sorted by recency, up to 50 results."}],"resultDescription":"A list of Hacker News items (stories and/or comments) matching the query, including fields such as title, URL, author, score, creation timestamp, and object type, ranked by the chosen sort order (relevance or recency), up to the requested limit.","failureModes":["Empty results if query matches nothing or date range is too narrow","Rate limiting or payment failure if USDC balance is insufficient","Invalid enum value for sort or type fields returns validation error","limit exceeding 50 or since_days exceeding 3650 rejected by schema","Query string left blank returns error (q is required)"],"whenToPreferThis":"Choose this endpoint when you need to search Hacker News content specifically — either stories or comments — with control over sort order and recency window. It is ideal for competitive intelligence, technology trend monitoring, developer community sentiment, and tracking mentions of specific products, companies, or projects within the HN ecosystem. Prefer it over generic web search when the HN community perspective is specifically valuable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:46:24.413Z","isFirstParty":false,"canonicalSlug":"hacker-news-search-stories-or-comments-by-relevance-or-recency-2edc65fb"}