{"uid":"cap_5H7bko0Z4YmZgRLVo-fKw","slug":"hacker-news-search-via-x402-agentutility-fc531235","name":"Hacker News Search via x402 AgentUtility","description":"Searches 30M+ Hacker News stories and comments via the public Algolia HN index. Filter by type (story|comment|poll), author, minimum points, ISO8601 date range (since/until), and sort by relevance or recency. Returns total hit count plus per-hit objectID, title, author, points, comment count, created_at, URL, and story/comment text. Public Algolia API, no auth, commercial-OK. Use it as an HN search, yc-news or startup-news search, who-is-hiring scraper, or programmer-news firehose.","url":"https://x402.agentutility.ai/hn-search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["query"],"properties":{"sort":{"enum":["relevance","date"],"type":"string","description":"'relevance' (default, popularity-weighted) or 'date' (most-recent-first)."},"type":{"enum":["story","comment","poll"],"type":"string","description":"Restrict to a single HN item type. Omit to include all types."},"limit":{"type":"number","description":"Max hits to return. 1-20. Default 10."},"query":{"type":"string","description":"Free-text search query (matches title, body, author, URL)."},"since":{"type":"string","description":"Lower bound on created_at — ISO8601 date (YYYY-MM-DD) or full timestamp."},"until":{"type":"string","description":"Upper bound on created_at — ISO8601 date (YYYY-MM-DD) or full timestamp."},"author":{"type":"string","description":"Filter to a specific HN username (e.g. 'pg', 'dang')."},"min_points":{"type":"number","description":"Minimum points (upvotes) floor. Comments don't have points; using this implicitly filters to stories."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"points":{"type":"integer"},"created_at":{"type":"string"},"comments_count":{"type":"integer"}}}},"total_hits":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"query":"rust async","source":"https://hn.algolia.com/api/v1/search","results":[{"id":"39800000","url":"https://without.boats/blog/async-rust-3/","title":"Async Rust in three parts","author":"boats","points":412,"created_at":"2024-03-15T14:22:01.000Z","comments_count":137}],"total_hits":4567}},"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_gBOF575NuuuLnbwSZqeri","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches 30M+ Hacker News stories and comments using the Algolia HN index, with filters for type, author, points, date range, and sort order","exampleAgentPrompt":"Search Hacker News for stories about 'AI agents' with at least 50 points, posted between 2024-01-01 and 2025-01-01, sorted by relevance — I want the top results including title, author, score, and URL.","exampleUseCases":[{"title":"Who Is Hiring thread scraper","prompt":"Find the most recent 'Ask HN: Who is Hiring' story from the last 30 days and pull all top-level comments mentioning 'remote' and 'Python' — I'm looking for new job listings."},{"title":"Startup competitor news monitor","prompt":"Search Hacker News for any stories or comments mentioning 'Notion' from the past 6 months with at least 10 points, sorted by recency — I want to see what the community has been saying about them."},{"title":"YC batch announcement research","prompt":"Find HN stories about 'YC W25' or 'Y Combinator Winter 2025' posted since 2025-01-01, sorted by relevance, and give me the titles, URLs, and point counts for the top results."}],"resultDescription":"Returns a total hit count and a list of matching items, each containing: objectID, story title, author username, upvote points, number of comments, creation timestamp (ISO8601), source URL, and the full story or comment text where available.","failureModes":["Empty results if query terms are too specific or misspelled","Date range with no matching content returns zero hits","Invalid type filter value causes request error","Very broad queries may return noisy or irrelevant results","Rate limits on the underlying Algolia API may cause transient failures","x402 payment failure if wallet has insufficient USDC balance"],"whenToPreferThis":"Choose this endpoint when you need to search or scrape Hacker News content at scale — including stories, comments, polls, or Who Is Hiring threads — especially when you need filtering by date, author, points, or content type. It's ideal over manually accessing HN or the raw Algolia API because it's wrapped as an x402-payable, agent-callable endpoint with no auth setup, making it plug-and-play for autonomous agents. Prefer it over Twitter/X search when you specifically need tech-savvy programmer community discourse, YC news, or startup ecosystem discussions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:36.615Z","isFirstParty":false}