{"uid":"cap_zxvFtBW2CDg5GTPuGlzD3","slug":"hacker-news-engagement-metrics-via-algolia-search-b97f12d3","name":"Hacker News Engagement Metrics via Algolia Search","description":"Hacker News engagement / dev-sentiment for a project or topic: story count, total & average points and comments, and the top stories (title/url/points/comments/date). From the keyless HN Algolia search API.","url":"https://webtools402.176-109-107-191.sslip.io/dev/hn","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","required":["query"],"properties":{"days":{"type":"integer","maximum":3650,"minimum":1,"description":"Look-back window in days (default 365)"},"query":{"type":"string","description":"Free-text search query (project/topic name)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_esPkcBUtMgmgPgQfgg2DB","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":"Returns Hacker News story count, total/average points and comments, and top stories for a given search query over a configurable time window.","exampleAgentPrompt":"How is 'Deno' performing on Hacker News over the last 180 days — give me the story count, average points, and the top posts.","exampleUseCases":null,"resultDescription":"A structured summary including total story count, total and average points and comments, and a list of top Hacker News stories (title, URL, points, comment count, date) matching the query within the specified time window.","failureModes":["Missing required 'query' parameter returns an error","Days value outside 1–3650 range is rejected by schema validation","Obscure or misspelled queries may return zero stories with empty results","Network or upstream Algolia API downtime causes 5xx responses","Payment failure or insufficient USDC balance blocks access"],"whenToPreferThis":"Choose this endpoint when you need quantitative Hacker News engagement data — story count, aggregated points and comments, and top posts — for a project, library, or topic. It is ideal for gauging developer community interest or sentiment without needing an API key, as it wraps the free Algolia HN search API. Prefer this over scraping or manual HN search when you need structured, aggregated metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:04.421Z","isFirstParty":false}