{"uid":"cap_4Hdxko2JAR6s1ljbt2eVa","slug":"hacker-news-search-stories-5fc45fde","name":"Hacker News Search & Stories","description":"Hacker News Search & Stories: full-text search of Hacker News stories or comments (HN Search by Algolia). Per hit the title, text, author, points, comment count, linked URL, time and item URL in the shared social schema; next_cursor gives the next page. Tech news, launches and developer discussion for market and competitor research. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/hackernews/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","maxLength":200,"description":"Search text (1-200 characters)."},"type":{"enum":["story","comment"],"type":"string","description":"story or comment. Default story."},"limit":{"type":"string","pattern":"^[0-9]{1,4}$","description":"Results per page, 1-20. Default 20."},"cursor":{"type":"string","maxLength":6,"description":"next_cursor of the previous page (a page number)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"40000001","url":"https://news.ycombinator.com/item?id=40000001","lang":null,"text":null,"type":"post","title":"Show HN: Synthwidget, a synthetic widget","author":{"handle":"synth_hn_user1","verified":null,"followers":null,"display_name":null},"metrics":{"likes":128,"views":null,"replies":47,"reposts":null},"link_url":"https://example.invalid/synthwidget","platform":"hackernews","parent_id":null,"created_at":"2026-10-13T14:00:00.000Z","media_urls":[]},{"id":"40000002","url":"https://news.ycombinator.com/item?id=40000002","lang":null,"text":null,"type":"post","title":"Ask HN: Anyone using synthwidget?","author":{"handle":"synth_hn_user2","verified":null,"followers":null,"display_name":null},"metrics":{"likes":5,"views":null,"replies":2,"reposts":null},"link_url":null,"platform":"hackernews","parent_id":null,"created_at":"2026-10-12T10:13:20.000Z","media_urls":[]}],"query":{"q":"synthetic widgets","type":"story","limit":10,"cursor":null},"source":"public data via the Hacker News API (Algolia search and Firebase); not affiliated with Y Combinator","complete":true,"platform":"hackernews","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":"1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DBI5CF82GvLuQYPpGJElN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Full-text search of Hacker News stories or comments via Algolia, returning titles, authors, points, comment counts, URLs, and timestamps.","exampleAgentPrompt":"Search Hacker News stories for 'WebAssembly' and give me the top 10 results — I want to see what the developer community has been saying about it lately.","exampleUseCases":[{"title":"Competitor launch monitoring on HN","prompt":"Search Hacker News stories for 'Notion AI' and show me the top 20 results so I can see how the community reacted to their launch and what developers are saying."},{"title":"Show HN discovery for a launch","prompt":"Look up Hacker News stories mentioning 'Rust async' — I want the top 10 to understand what projects or articles are getting traction in that space."},{"title":"Market research on developer sentiment","prompt":"Can you search Hacker News comments for 'Kubernetes cost' and return the first page of results? I'm trying to understand what pain points developers are discussing around cloud infrastructure spending."}],"resultDescription":"Returns a paginated list of HN story or comment hits, each containing the item ID, HN item URL, title, author handle, points (likes), reply count, linked URL, platform ('hackernews'), and creation timestamp. Also includes a next_cursor for fetching subsequent pages, the original query echo, a source disclaimer, and a request ID.","failureModes":["Empty results array when no HN stories or comments match the query — not charged","Missing or malformed 'q' parameter causes validation error","Invalid cursor value may return unexpected page or error","Rate limits or upstream Algolia/Firebase outages may cause failures","Queries over 200 characters are rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you specifically need to search Hacker News stories or comments by keyword — ideal for tech market research, developer sentiment analysis, competitor monitoring, or discovering trending launches in the HN community. Prefer this over general social search when the audience is explicitly developers and tech professionals, or when you need HN-specific signals like points and comment counts. Use the companion 'Hacker News Comments & Threads' endpoint when you already have a specific HN item ID and want the full thread.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:45.708Z","isFirstParty":false,"canonicalSlug":"hacker-news-search-stories-5fc45fde"}