{"uid":"cap_eclTfC9GZ8iqujh3zfya6","slug":"2s-io-hacker-news-full-text-search-da1c9d06","name":"2s.io Hacker News Full-Text Search","description":"Full-text search across all of Hacker News (via the Algolia HN API). Search stories or comments by keyword, sorted by relevance or by date (newest first). Filter by tags (story/comment/ask_hn/show_hn/poll) and by author. Each hit: title, URL, author, points, comment count, story/comment text, created time, and canonical HN URL. Net-new vs news.hn-top (curated feeds) and news.search (general news).","url":"https://2s.io/api/news/hn-search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"sort":{"enum":["relevance","date"],"type":"string"},"tags":{"enum":["story","comment","ask_hn","show_hn","poll"],"type":"string"},"limit":{"type":"integer","maximum":50,"minimum":1},"query":{"type":"string","default":"","maxLength":400,"description":"Search keywords (may be empty when filtering by tags/author)."},"author":{"type":"string","maxLength":40,"description":"Restrict to one HN author."}},"additionalProperties":false}}}}},"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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Oy4aYZOGGZ0qFDgON0ge3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Full-text search across all of Hacker News stories and comments via Algolia, filterable by type, author, and sortable by relevance or date.","exampleAgentPrompt":"Search Hacker News for stories about 'large language models', sorted by date, and give me the top 10 results — I want titles, URLs, authors, and point counts.","exampleUseCases":null,"resultDescription":"A list of up to 50 Hacker News hits (stories or comments), each containing title, URL, author, points, comment count, story or comment text, creation timestamp, and a canonical HN link — ordered by relevance or newest-first depending on the sort parameter.","failureModes":["Empty query with no tags or author filter returns broad/noisy results","Queries exceeding 400 characters are rejected","Limit values outside 1–50 are rejected","Author names not matching any HN user return zero results","Rare or very niche keywords may return zero hits","Algolia upstream outage causes 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need full-text search across the entire Hacker News corpus — including historical stories and comments — rather than just today's top/new feeds. Ideal for finding community discussions, opinions, or announcements about a specific topic, technology, or author on HN. Prefer over general news search when the user specifically wants the tech/startup community's perspective via Hacker News.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:29.662Z","isFirstParty":false}