{"uid":"cap_h6WS6pN9bMhIU4GB8rFWC","slug":"sitecheck-hacker-news-search-917d5a5f","name":"SiteCheck Hacker News Search","description":"Full-text search of Hacker News stories or comments through the Algolia HN API: title, URL, author, points, comment count, time and HN link; comments include their text (max 500 characters). Filters: date range (from, to as YYYY-MM-DD), minimum points, sort by relevance or date. Covers the public HN index only; limit max 25.","url":"https://api.sitecheck-api.workers.dev/api/hn/search?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","required":["q"],"properties":{"q":{"type":"string","description":"Search words (1-200 characters)"},"to":{"type":"string","description":"Latest creation date YYYY-MM-DD (optional)"},"from":{"type":"string","description":"Earliest creation date YYYY-MM-DD (optional)"},"sort":{"type":"string","description":"relevance (default) or date (newest first)"},"type":{"type":"string","description":"story (default) or comment"},"limit":{"type":"string","description":"Results, 1-25 (default 10)"},"minPoints":{"type":"string","description":"Minimum points (default 0)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"sort":"relevance","type":"story","count":3,"query":"rust","nbHits":60865,"source":"Hacker News via the Algolia HN Search API (hn.algolia.com/api) — Hacker News content, check its terms","results":[{"id":"22238335","url":"https://blog.discordapp.com/why-discord-is-switching-from-go-to-rust-a190bbca2b1f","hnUrl":"https://news.ycombinator.com/item?id=22238335","title":"Why Discord is switching from Go to Rust","author":"Sikul","points":1582,"comments":642,"createdAt":"2020-02-04T17:30:40Z"},{"id":"40172033","url":"https://loglog.games/blog/leaving-rust-gamedev/","hnUrl":"https://news.ycombinator.com/item?id=40172033","title":"Leaving Rust gamedev after 3 years","author":"darthdeus","points":1484,"comments":972,"createdAt":"2024-04-26T17:33:56Z"},{"id":"25610741","url":"https://fasterthanli.me/articles/a-half-hour-to-learn-rust","hnUrl":"https://news.ycombinator.com/item?id=25610741","title":"A half-hour to learn Rust","author":"selvan","points":1444,"comments":330,"createdAt":"2021-01-02T05:50:39Z"}],"checkedAt":"2026-10-15T18:21:08.101Z"}},"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_MRHz7O78VK6kBCXkvdM4R","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":"Search Hacker News stories and comments by keyword with optional date range, sort order, and minimum points filters","exampleAgentPrompt":"Search Hacker News for the top stories about WebAssembly, sorted by relevance, with at least 100 points — give me the 10 best results.","exampleUseCases":[{"title":"Developer sentiment on new framework","prompt":"Search Hacker News for discussions about the Bun JavaScript runtime, sorted by relevance, and show me the top 10 stories with at least 50 points so I can see what developers think of it."},{"title":"Recent HN coverage of a company","prompt":"Find the most recent Hacker News stories mentioning OpenAI from the last month — sort by date and give me up to 15 results."},{"title":"Researching a tech concept via HN","prompt":"Search Hacker News for stories about 'large language model fine-tuning' sorted by relevance, limited to 5 results — I want to see what the community has been saying."}],"resultDescription":"Returns a JSON object with the search query, sort mode, content type, total hit count, and an array of up to 25 matching results. Each result includes the HN item ID, original article URL, direct HN link, title, author username, upvote points, comment count, and ISO 8601 creation timestamp. Also includes metadata about the data source and the time the query was executed.","failureModes":["Missing required 'q' parameter returns a 400 error","Query string exceeding 200 characters may be rejected","Date strings not in YYYY-MM-DD format may cause a 400 or unexpected results","Invalid 'sort' value (not 'relevance' or 'date') may default or error","Limit outside 1-25 range may be clamped or rejected","Algolia upstream outage may cause 502 or empty results","Very niche queries may return 0 hits even when valid"],"whenToPreferThis":"Choose this endpoint when you need to search Hacker News specifically — for developer sentiment, community reactions, or tech-focused discussions. It wraps the Algolia HN Search API with date filtering, minimum-points filtering, and story-vs-comment type selection in a single pay-per-call interface. Prefer it over general web search when the target audience is the Hacker News tech community and you want structured metadata (points, comments, author) alongside the URL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:48:18.473Z","isFirstParty":false,"canonicalSlug":"sitecheck-hacker-news-search-0366a4ab"}