{"uid":"cap_hEba1QXJUgy3JSNJppzzw","slug":"x402helper-xyz-hn-search-hacker-news-free-text-query-8cd86135","name":"x402helper.xyz HN Search — Hacker News Free-Text Query","description":"X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.","url":"https://x402helper.xyz/89e509/dev/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","required":["query"],"properties":{"days":{"type":"integer","default":null,"maximum":3650,"minimum":1,"description":"Look-back window in days (default 365)"},"query":{"type":"string","default":null,"description":"Free-text search query (project/topic name)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SHikm6TqBBcj7rOf30PaJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Hacker News posts and projects by free-text query over a configurable look-back window, returning structured results via x402 micropayment.","exampleAgentPrompt":"Search Hacker News for anything about 'Rust async runtimes' over the last 180 days and show me what comes up.","exampleUseCases":[{"title":"Competitive research on HN buzz","prompt":"Search Hacker News for posts about 'Supabase' from the last 90 days — I want to see what the developer community is saying about them recently."},{"title":"Monitoring a new open-source project","prompt":"Look up 'Gleam language' on Hacker News over the past 365 days so I can get a sense of how much traction it's gaining in the community."},{"title":"Finding historical HN discussion","prompt":"Search Hacker News for 'prompt injection' going back 2 years — I'm researching how awareness of the issue has evolved."}],"resultDescription":"A JSON object with a 'success' boolean and a 'result' object containing Hacker News posts or project entries matching the free-text query within the specified look-back window, likely including titles, URLs, scores, and timestamps.","failureModes":["Missing required 'query' parameter returns an error","Payment not completed or insufficient USDC balance causes 402 rejection","'days' value exceeding 3650 or below 1 returns a validation error","Empty result set when no HN posts match the query in the given window","Network timeout if the upstream HN search index is slow"],"whenToPreferThis":"Use this endpoint when you need to search Hacker News specifically for developer community sentiment, project mentions, or tech discussions, and you want a configurable look-back window. It is better than generic web search when HN-specific community signal is the goal, and better than manual HN search when integrating results into an automated agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:15.506Z","isFirstParty":false,"canonicalSlug":"x402helper-xyz-hn-search-hacker-news-free-text-query-8cd86135"}