{"uid":"cap_i-4JMMFFpQRWdRm3qE4hW","slug":"hn-pulse-f2238713","name":"HN Pulse","description":"Top Hacker News stories for a topic, ranked by points and comments.","url":"https://k2so.wrong.systems/api/services/hn-pulse","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"sector":{"type":"string","description":"Composite input parameter"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"HN Pulse paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"score":{"type":"number"},"service":{"type":"string","description":"Service slug"},"summary":{"type":"string"},"evidence":{"type":"object"},"strengths":{"type":"array","items":{"type":"string"}},"confidence":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"riskFactors":{"type":"array","items":{"type":"string"}}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"service":"hn-pulse"},"service":"hn-pulse","provider":"K-2SO"}},"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_cRYN1sA7XFE3cMT4B4gCF","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":"Returns top Hacker News stories for a given topic, ranked by points and comments.","exampleAgentPrompt":"Can you pull the top Hacker News stories about large language models right now, ranked by points and comments?","exampleUseCases":[{"title":"Tech trend pulse for a newsletter","prompt":"What are the hottest Hacker News stories about AI agents this week? I want to see them ranked by points and comments so I can pick the best ones for my newsletter."},{"title":"Competitor sentiment on HN","prompt":"Find the top Hacker News discussions about Stripe — I want to know what the developer community is saying and which posts are getting the most traction."},{"title":"Research topic popularity check","prompt":"I'm about to write a blog post on WebAssembly — can you check what the top HN stories on that topic are and summarize the community sentiment?"}],"resultDescription":"Returns a ranked list of top Hacker News stories matching the given topic, including scores, comment counts, a summary of community sentiment, confidence rating, strengths, evidence details, and risk factors. Response also includes metadata about the service and payment confirmation.","failureModes":["Missing or empty sector parameter returns no results","Topic too broad or misspelled may yield irrelevant stories","Payment failure (402) if USDC balance is insufficient","Rate limiting or service unavailability from upstream HN data source","No stories found for niche or very new topics"],"whenToPreferThis":"Use this endpoint when you need a quick, ranked snapshot of what the Hacker News developer community is currently discussing about a specific technology, company, or topic. It is preferable over raw HN API queries when you want pre-ranked, summarized results with sentiment signals rather than raw story data. Best for trend discovery, research validation, and newsletter curation in tech-savvy domains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:09.196Z","isFirstParty":false}