{"uid":"cap_GssEXPwbt25FRKAHxK5fg","slug":"hacker-news-search-via-x402-3b1ba627","name":"Hacker News Search via x402","description":"Search Hacker News stories or comments by keyword, newest or most relevant first, with points, comment count, author, URL and HN link. Good for tracking mentions of a product, company or topic. Deterministic, no LLM.","url":"https://138-197-15-135.sslip.io/v1/social/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":["queryParams"],"properties":{"queryParams":{"type":"object","required":["q"],"properties":{"n":{"type":"string","description":"Results 1-30"},"q":{"type":"string","description":"Keyword"},"sort":{"type":"string","description":"relevance (default) or date"},"type":{"type":"string","description":"story (default) or comment"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":[],"properties":{"q":{"type":["string","null"]},"hits":{"type":["array","null"]},"count":{"type":["integer","null"]}}}}}}},"responseSchema":{"type":"json","example":{"q":"x402","hits":[{"hn":"https://news.ycombinator.com/item?id=1","url":"...","title":"...","author":"pg","points":12,"comments":3,"createdAt":"2026-01-01T00:00:00Z"}],"count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CccPmsmLgpBXaZQB-GF3e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Hacker News stories and comments by keyword, returning ranked results with metadata, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Search Hacker News for the top 10 stories about 'WebAssembly', sorted by relevance, and show me the titles, authors, and point counts.","exampleUseCases":[{"title":"Track startup launch reception on HN","prompt":"Search Hacker News for stories mentioning 'Notion' and show me the top 5 results sorted by relevance — I want to see how the community has reacted to them."},{"title":"Find latest HN threads on a language","prompt":"Can you find the 15 most recent Hacker News stories about 'Rust programming language' sorted by date? I want to catch up on what's being discussed right now."},{"title":"Monitor HN sentiment on a new protocol","prompt":"Search Hacker News comments mentioning 'x402' — give me up to 20 results sorted by relevance so I can see what developers are saying about it."}],"resultDescription":"A JSON object containing the search query, a count of matched results, and an array of hits. Each hit includes the HN item URL, title, author username, upvote points, number of comments, and ISO 8601 creation timestamp.","failureModes":["Missing required 'q' parameter returns validation error","Invalid 'sort' value (not 'relevance' or 'date') may return error or default behavior","Invalid 'type' value (not 'story' or 'comment') may return error","'n' outside 1-30 range may be clamped or rejected","Payment failure via x402 returns 402 status before search executes","Keyword with no HN matches returns empty hits array with count 0","HN upstream (Algolia) downtime returns service unavailable error"],"whenToPreferThis":"Choose this endpoint when you need programmatic, per-call Hacker News search paid via x402 USDC micropayments without managing API keys or subscriptions. Ideal for AI agents that need lightweight, pay-as-you-go access to HN content discovery, especially when also using other x402-enabled endpoints on the same platform. Prefer over direct Algolia HN API integration when you want a unified x402 payment flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:22.102Z","isFirstParty":false,"canonicalSlug":"hacker-news-search-via-x402-3b1ba627"}