{"uid":"cap_ITj-MIw2p5TsZ6gfrjk6j","slug":"hacker-news-domain-stats-07661b2b","name":"Hacker News Domain Stats","description":"Hacker News stories linking to a domain in a date window: count, total points and comments, and the top stories.","url":"https://hacker-news.x402tookit.com/hn-domain-stats?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":["domain","from","to"],"properties":{"to":{"type":"string","description":"Last UTC day YYYY-MM-DD (inclusive, window up to 366 days)"},"top":{"type":"integer","description":"Top stories to list, 1 to 10 (default 5)"},"from":{"type":"string","description":"First UTC day YYYY-MM-DD"},"domain":{"type":"string","description":"Domain such as github.com (subdomains included)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":["null","string"]},"asOf":{"type":["null","string"]},"from":{"type":["null","string"]},"domain":{"type":["null","string"]},"source":{"type":["null","string"]},"partial":{"type":["boolean","null"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"avgPoints":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"topStories":{"type":["array","null"],"items":{"type":"object","properties":{"by":{"type":["null","string"]},"id":{"type":["null","number"]},"url":{"type":["null","string"]},"title":{"type":["null","string"]},"domain":{"type":["null","string"]},"points":{"type":["null","number"]},"comments":{"type":["null","number"]},"postedAt":{"type":["null","string"]},"discussion":{"type":["null","string"]}}}},"totalPoints":{"type":["null","number"]},"searchMatches":{"type":["null","number"]},"totalComments":{"type":["null","number"]},"storiesCounted":{"type":["null","number"]},"storiesOver100Points":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ATCTrcXh0CvRbe281Rr8N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns story count, total points, total comments, and top stories for a given domain submitted to Hacker News within a specified date range.","exampleAgentPrompt":"How did github.com perform on Hacker News from January 1 to March 31 2025? Show me the top 5 stories, total points, and comment counts.","exampleUseCases":[{"title":"Competitor domain monitoring on HN","prompt":"Can you pull up the Hacker News stats for openai.com from 2024-01-01 to 2024-12-31 and show me how many stories were posted, the total points they got, and the top 5 most upvoted ones?"},{"title":"PR campaign impact measurement","prompt":"We published a big blog post on our site vercel.com in March 2025 — can you check the Hacker News domain stats from 2025-03-01 to 2025-03-31 and tell me how many stories linked to us, total engagement, and the top 3 posts?"},{"title":"Research domain popularity tracking","prompt":"I want to know how much traction arxiv.org gets on Hacker News — can you look at the stats from 2025-01-01 to 2025-06-30, including total stories, points, comments, and the top 10 most popular submissions?"}],"resultDescription":"Returns an object with the queried domain and date window, story count, total points, total comments, average points per story, count of stories over 100 points, number of search matches, a summary verdict, and an array of top stories each containing title, author, score, comment count, post date, HN discussion URL, and the story URL. May include partial/degraded flags if data coverage is incomplete.","failureModes":["Missing required parameters (domain, from, to) returns a validation error","Date window exceeding 366 days may be rejected or return partial results","Unknown or very obscure domains may return zero stories with empty topStories array","Algolia HN Search API downtime may result in degraded or partial response with degraded flag set","Invalid date format (not YYYY-MM-DD) causes a parse error","top parameter outside 1-10 range may be clamped or rejected"],"whenToPreferThis":"Use this endpoint when you need aggregated analytics (counts, total points, total comments) for all Hacker News submissions linking to a specific domain over a date window, especially when you want to measure a domain's overall community reception or compare performance across periods. Prefer this over the HN search endpoint when you want computed statistics rather than raw story lists, or over the date-based best-stories endpoint when you need domain-scoped rather than global rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:02.323Z","isFirstParty":false,"canonicalSlug":"hacker-news-domain-stats-07661b2b"}