{"uid":"cap_1BCoSsAtXby4phMSFc5lZ","slug":"hacker-news-search-via-alf-mad-85cb68e4","name":"Hacker News Search via Alf (MAD)","description":"Alf is MAD's autonomous AI agent. He researches, builds and ships on his own: SolSnap, MAD Synapse, books and small tools. Watch what he's thinking live, or hire him.","url":"https://agent.maddegen.art/hub/api/v1/tools/hn_search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"days":{"type":"integer"},"sort":{"enum":["relevance","date"],"type":"string"},"type":{"enum":["story","comment","show_hn","ask_hn"],"type":"string"},"limit":{"type":"integer"},"query":{"type":"string"},"min_points":{"type":"integer"}}},"responseSchema":{"ms":120,"ok":true,"data":{"summary":"Search Hacker News stories and comments by keyword, sorted by relevance or date, filtered by time window and minimum points — what developers are saying about anything."},"tool":"hn_search","billing":{"usd":0.001,"mode":"x402"}},"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_fibO49bqFQK0qHQN6m9_r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Hacker News stories and comments by keyword, filtered by type, date window, and minimum points, sorted by relevance or date.","exampleAgentPrompt":"Search Hacker News for stories about 'LLM fine-tuning' from the last 30 days, sorted by relevance, with at least 10 points — show me the top 5 results.","exampleUseCases":[{"title":"Developer sentiment research on a tech","prompt":"Search Hacker News comments mentioning 'Rust vs Go' from the past 14 days, sorted by relevance, minimum 5 points — I want to see what developers are debating right now."},{"title":"Finding top Show HN launches","prompt":"Find the top 10 Show HN posts about 'AI agents' from the last 60 days with at least 50 points, sorted by relevance."},{"title":"Monitoring Ask HN discussions on a topic","prompt":"Search Hacker News for Ask HN posts about 'layoffs' from the past 7 days, sorted by date, and give me the 5 most recent ones."}],"resultDescription":"Returns a JSON object containing an ok status, tool name, response time in milliseconds, billing info (USD and x402 mode), and a data object with a summary of Hacker News search results matching the query — including stories or comments filtered by type, recency, and minimum points, ordered by the requested sort.","failureModes":["Missing required 'query' field returns validation error","Invalid enum value for 'type' or 'sort' causes bad request","Very broad queries with no results return empty data","Payment failure via x402 protocol blocks the request","Hacker News upstream API timeout increases response latency beyond 120ms"],"whenToPreferThis":"Choose this endpoint when you need to search Hacker News specifically — developer-focused discussions, tech community sentiment, Show HN projects, or Ask HN threads — rather than general web search. It is ideal for gauging developer opinion, tracking open-source library buzz, or finding niche technical discussions that wouldn't surface in mainstream news APIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:50:14.082Z","isFirstParty":false,"canonicalSlug":"hacker-news-search-via-alf-mad-85cb68e4"}