{"uid":"cap_AIaaUuTJdR6dK0HIre6co","slug":"hacker-news-front-page-by-date-cf93569f","name":"Hacker News Front Page by Date","description":"Best-scored Hacker News stories submitted on a UTC date (past front pages are not archived), flagged if still on the front page.","url":"https://hacker-news.x402tookit.com/hn-front-page-date?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":["date"],"properties":{"date":{"type":"string","description":"UTC day YYYY-MM-DD, not in the future"},"limit":{"type":"integer","description":"Stories 1 to 30 (default 15)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"date":{"type":["null","string"]},"basis":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"stories":{"type":["array","null"],"items":{"type":"object","properties":{"by":{"type":["null","string"]},"id":{"type":["null","number"]},"url":{"type":["null","string"]},"rank":{"type":["null","number"]},"title":{"type":["null","string"]},"domain":{"type":["null","string"]},"points":{"type":["null","number"]},"comments":{"type":["null","number"]},"postedAt":{"type":["null","string"]},"discussion":{"type":["null","string"]},"onFrontPageNow":{"type":["boolean","null"]}}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"storiesScoring20Plus":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tHgVyaKb0qxxthDkbveKi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the best-scored Hacker News stories submitted on a given UTC date, flagged if they are currently on the front page.","exampleAgentPrompt":"What were the top 20 Hacker News stories from March 10, 2024, and are any of them still on the front page right now?","exampleUseCases":[{"title":"Research a tech news day","prompt":"What were the biggest Hacker News stories on November 30, 2023? Give me the top 15 with their scores and comment counts."},{"title":"Check launch day coverage","prompt":"We launched our product on February 14, 2024 — can you pull the top Hacker News stories from that day and tell me if anything about us made it?"},{"title":"Monitor yesterday's front page","prompt":"What were the best-scoring Hacker News posts from yesterday, and which ones are still live on the front page right now? Show me up to 25 stories."}],"resultDescription":"Returns a ranked list of up to 30 Hacker News stories for the requested UTC date, each including title, URL, domain, author, points, comment count, posting timestamp, rank, discussion link, and a flag indicating whether the story is currently on the front page. Also includes metadata such as an 'asOf' timestamp, data source URL, a summary, number of stories scoring 20+ points, degraded-mode indicator, and any reasons or disclaimers about data quality.","failureModes":["Date is in the future — endpoint rejects future dates","Date has no archived stories — returns empty or degraded result with reasons","Invalid date format provided — schema validation error","Network or upstream HN API failure — degraded flag set to true with explanation","Limit out of range (below 1 or above 30) — validation error"],"whenToPreferThis":"Use this endpoint when you need historical Hacker News story rankings for a specific past UTC date, especially when you want to know which stories were most popular on that day and whether any are still trending. Prefer this over the current top-stories endpoint when the date is in the past. Use the search endpoint instead if you need keyword or topic filtering across a date range rather than a specific day's top stories.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:08.471Z","isFirstParty":false,"canonicalSlug":"hacker-news-front-page-by-date-cf93569f"}