{"uid":"cap_T_Gow95JangaPZAvEiEQA","slug":"x402-deployer-x402-deployer-workers-dev-d739d923","name":"Hacker News Search via Algolia","description":"Hacker News search / HN search / yc-news / Algolia HN. Searches 30M+ Hacker News stories and comments. Filter by type (story/comment/poll), author, min points, ISO8601 date range; sort by relevance or recency. Returns title, author, points, comment count, URL.","url":"https://x402-deployer.x402-deployer.workers.dev/hacker-news-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":null,"example":{"request":{"type":"story","query":"artificial intelligence","sortBy":"points","dateRange":{"end":"2024-12-31T23:59:59Z","start":"2024-06-01T00:00:00Z"},"minPoints":50},"response":{"query":"artificial intelligence","source":"https://hn.algolia.com/api/v1/search","results":[{"id":"21530860","url":"https://www.facebook.com/100006735798590/posts/2547632585471243/","title":"John Carmack: I’m going to work on artificial general intelligence","author":"jbredeche","points":1574,"created_at":"2019-11-13T23:17:23Z","comments_count":889},{"id":"48387270","url":"https://www.theatlantic.com/philosophy/2026/06/no-artificial-intelligence-is-not-conscious/687378/","title":"Artificial intelligence is not conscious – Ted Chiang","author":"lordleft","points":800,"created_at":"2026-06-03T17:51:37Z","story_text":"<a href=\"https:&#x2F;&#x2F;archive.is&#x2F;bcpZl\" rel=\"nofollow\">https:&#x2F;&#x2F;archive.is&#x2F;bcpZl</a>","comments_count":1383},{"id":"21953593","url":"https://www.reuters.com/article/us-usa-artificial-intelligence/u-s-government-limits-exports-of-artificial-intelligence-software-idUSKBN1Z21PT","title":"U.S. government limits exports of artificial intelligence software","author":"ckcheng","points":595,"created_at":"2020-01-04T08:02:49Z","comments_count":211},{"id":"41295923","url":"https://www.economist.com/finance-and-economics/2024/08/19/artificial-intelligence-is-losing-hype","title":"Artificial intelligence is losing hype","author":"bx376","points":568,"created_at":"2024-08-20T01:13:23Z","comments_count":780},{"id":"18219444","url":"https://www.nytimes.com/2018/10/15/technology/mit-college-artificial-intelligence.html","title":"M.I.T. Plans College for Artificial Intelligence, Backed by $1B","author":"superfx","points":560,"created_at":"2018-10-15T13:26:14Z","comments_count":164},{"id":"12667761","url":"https://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-034-artificial-intelligence-fall-2010/lecture-videos/","title":"Artificial Intelligence Lecture Videos","author":"BucketSort","points":540,"created_at":"2016-10-08T17:27:17Z","comments_count":49},{"id":"17040368","url":"https://www.cs.cmu.edu/news/carnegie-mellon-launches-undergraduate-degree-artificial-intelligence","title":"Carnegie Mellon Launches Undergraduate Degree in Artificial Intelligence","author":"e15ctr0n","points":502,"created_at":"2018-05-10T16:28:03Z","comments_count":339},{"id":"28394834","url":"https://www.bmj.com/content/374/bmj.n1872","title":"Use of artificial intelligence for image analysis in breast cancer screening","author":"cratermoon","points":439,"created_at":"2021-09-02T17:26:09Z","comments_count":323},{"id":"9386004","url":"http://acuman.us/","title":"Show HN: I'm a 14 year-old dev who has programmed an artificial intelligence bot","author":"seanlevan","points":430,"created_at":"2015-04-16T05:21:03Z","comments_count":297},{"id":"15155609","url":"https://docs.google.com/presentation/d/119VW6ueBGLQXsw-jGMboGP2-WuOnyMAOYLgd44SL6xM/edit#slide=id.p","title":"Where will artificial general intelligence come from?","author":"nshr","points":389,"created_at":"2017-09-02T12:24:35Z","comments_count":240}],"total_hits":12853}},"exampleRequest":{"type":"story","query":"artificial intelligence","sortBy":"points","dateRange":{"end":"2024-12-31T23:59:59Z","start":"2024-06-01T00:00:00Z"},"minPoints":50},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_cBqckul6Xq9XXkDSbZRAi","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 with filtering by type, author, points, and date range, returning ranked results with metadata","exampleAgentPrompt":"Search Hacker News for stories about 'WebAssembly' from the last 6 months, sorted by points, with at least 50 points — only stories, not comments.","exampleUseCases":null,"resultDescription":"A list of matching Hacker News items each containing: title, author username, points score, comment count, original URL, and publication date; ranked by relevance or recency depending on sort parameter.","failureModes":["Invalid date format returns error (must be ISO8601)","Unknown sort parameter returns error","Empty query with no filters returns unfiltered results or error","Rate limit or payment failure returns 402 or 429","Very broad queries may return truncated result sets"],"whenToPreferThis":"Use this endpoint when you need to search or browse Hacker News content programmatically — especially when filtering by date range, minimum points, author, or post type. Prefer this over general web search when the user specifically wants HN community sentiment, top-voted tech discussions, or YC-adjacent startup news.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:49:54.781Z","isFirstParty":false}