{"uid":"cap_nmlZLxb4VI2JB4lSecG2Z","slug":"2s-io-7692b626","name":"2s.io Hacker News Feed","description":"Hacker News feed of items. Pass kind = top (default) | new | best | ask | show | job to pick the feed. Returns each item's id, type, author, time (unix + ISO), title, URL, text (for self-posts), score, descendant + kid counts, parent (for comments), dead/deleted flags, and canonical news.ycombinator.com URL. Default limit = 30, max 100. Useful for tech-sentiment + topic tracking.","url":"https://2s.io/api/news/hn-top","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"kind":{"enum":["top","new","best","ask","show","job"],"type":"string","default":"top"},"limit":{"type":"integer","default":30,"maximum":100,"minimum":1}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"kind":"top","limit":30}}},"response":{"_truncated":true,"_originalSize":13572}},"exampleRequest":{"kind":"top","limit":30},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0012/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_xc9aJHXm6-NoQVzygVttz","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":"Fetches a Hacker News feed (top, new, best, ask, show, or job) with full item metadata including scores, authors, URLs, and timestamps","exampleAgentPrompt":"Pull the top 50 stories from Hacker News right now — I want to see titles, scores, authors, and links so I can track what the tech community is buzzing about.","exampleUseCases":null,"resultDescription":"A list of up to 100 Hacker News items, each containing id, type, author, unix and ISO timestamps, title, URL, self-post text, score, descendant and kid counts, parent id (for comments), dead/deleted flags, and a canonical news.ycombinator.com URL. Default returns 30 items from the 'top' feed.","failureModes":["Invalid 'kind' enum value returns an error — must be one of top, new, best, ask, show, job","limit above 100 is rejected by schema validation","Payment failure (402) if USDC balance is insufficient","HN upstream outage may cause stale or empty results","Network timeout if HN API is slow to respond"],"whenToPreferThis":"Use this endpoint when you need structured Hacker News feed data with rich metadata (scores, authors, timestamps, URLs) in a single call without scraping. Prefer it over raw HN API calls when you need ISO timestamps and canonical URLs pre-formatted, or when you want to filter by feed type (ask, show, job) in one parameter. Best for tech sentiment tracking, topic monitoring, and developer community pulse-checking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:39.900Z","isFirstParty":false}