{"uid":"cap_duYrNqkjKo0xkkcCLxFgD","slug":"sitecheck-hacker-news-search-0366a4ab","name":"SiteCheck Hacker News Search","description":"Hacker News stories or comments from the Algolia search API: keyword search (q) or the current front page (mode=front), optionally since a date. Stories give title, URL, HN link, points, comments, author and time. Comments give their text (400 characters, HTML stripped) and the story title. Up to 50 results. Public data, no key.","url":"https://api.sitecheck-api.workers.dev/api/hn?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":"Keywords"},"mode":{"type":"string","description":"front: the current front page (stories only)"},"type":{"type":"string","description":"story (default) or comment"},"limit":{"type":"string","description":"Max results, 1-50, default 20"},"since":{"type":"string","description":"YYYY-MM-DD: only items from this day on"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":{"q":"x402","mode":null,"type":"story","since":null},"total":120,"source":"Hacker News via the Algolia HN Search API (https://hn.algolia.com/api). Posts belong to their authors; attribution: Hacker News (https://news.ycombinator.com)","results":[{"url":"https://example.com/x402-agents","hnUrl":"https://news.ycombinator.com/item?id=50001234","title":"Show HN: Pay-per-call APIs for AI agents with x402","author":"example","points":142,"comments":58,"createdAt":"2026-09-30T14:12:03Z"}],"returned":1,"checkedAt":"2026-10-13T18:40:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__YISr90aXDlkKKDJLwDXc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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, date, and type via the Algolia HN Search API","exampleAgentPrompt":"Search Hacker News for the top 10 stories about 'AI agents' posted since 2024-01-01 and give me the titles, scores, and links.","exampleUseCases":[{"title":"Monitor HN buzz around a product launch","prompt":"Search Hacker News for any stories or posts mentioning 'x402' from the last month — give me up to 20 results with titles, point counts, and links so I can see how the community is reacting."},{"title":"Fetch today's HN front page","prompt":"Pull the current Hacker News front page stories for me — use front mode and return the titles and URLs so I can see what's trending right now."},{"title":"Research community sentiment on a technology","prompt":"Find the top 15 Hacker News stories about 'WebAssembly' posted since 2023-06-01, sorted by relevance, so I can understand what developers are discussing and linking to."}],"resultDescription":"Returns a JSON object with the search query parameters echoed back, total matching item count, attribution/source note, and an array of results each containing the story URL, HN item URL, title, author username, upvote points, comment count, and ISO 8601 creation timestamp, plus the total returned count and a checkedAt timestamp.","failureModes":["Empty results array if query matches no HN items","Missing or malformed 'q' parameter may return front-page results or error","Invalid 'since' date format may cause query failure or be ignored","limit values outside 1-50 range may be clamped or rejected","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to search or browse Hacker News content programmatically — especially when looking for community discussion, developer sentiment, or trending technology topics. It wraps the Algolia HN Search API behind a pay-per-call interface, making it ideal for agents that need occasional HN lookups without managing their own Algolia integration. Prefer this over direct Algolia calls when you're already using the SiteCheck ecosystem for other tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:45:22.812Z","isFirstParty":false,"canonicalSlug":"sitecheck-hacker-news-search-0366a4ab"}