{"uid":"cap_Dwv9MD9rejB-hNGz4adSp","slug":"scrapemole-pulse-hacker-news-front-page-e2a6b19e","name":"ScrapeMole Pulse: Hacker News Front Page","description":"Pay-per-call \"state of the world\" lookups that language models cannot know on their own: official ECB exchange rates (latest, historical, conversion), the current time and DST-aware time-zone conversion for scheduling, global weather forecasts (MET Norway, by coordinates or place name) and the live Hacker News front page. Public, non-personal data with sources and licences in every response. USDC via x402, no accounts.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://pulse.scrapemole.workers.dev/terms","url":"https://pulse.scrapemole.workers.dev/v1/news/hn?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":[],"properties":{"list":{"type":"string","default":"top","examples":["top"],"description":"top, new, best, ask, show or job."},"limit":{"type":"string","default":"10","examples":["10"],"description":"Stories to return (1-30)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"list":"top","count":1,"source":"Hacker News API (https://github.com/HackerNews/API)","stories":[{"id":41234567,"url":"https://example.org/post","rank":1,"title":"Show HN: A pay-per-call API for agents","domain":"example.org","points":312,"comments":141,"postedAt":"2026-10-12T05:01:00Z","discussionUrl":"https://news.ycombinator.com/item?id=41234567"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DGleeOdYFxyoWavDgTQDo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live Hacker News stories (top, new, best, ask, show, or job lists) with titles, scores, comment counts, and URLs","exampleAgentPrompt":"What are the top 15 stories on Hacker News right now — show me titles, scores, and links?","exampleUseCases":[{"title":"Daily tech briefing digest","prompt":"Give me the top 10 Hacker News stories from today with their titles, scores, and URLs so I can put together a morning tech digest."},{"title":"Monitor Ask HN community questions","prompt":"Pull the top 10 Ask HN posts from Hacker News right now — I want to see what questions the developer community is currently discussing."},{"title":"Discover trending Show HN projects","prompt":"Fetch the top 20 Show HN stories from Hacker News — I'm looking for interesting new projects people are shipping this week."}],"resultDescription":"A JSON object containing the requested list type, story count, and an array of stories each with id, rank, title, URL, domain, points, comment count, ISO timestamp, and a direct link to the HN discussion thread. Source attribution to the Hacker News API is included.","failureModes":["Hacker News API unavailable — upstream outage returns error","Invalid list parameter value — must be one of top, new, best, ask, show, or job","Limit out of range — must be 1-30, invalid values may return error or be clamped","Payment not completed via x402 — 402 response returned before content is delivered","Network timeout from upstream HN API causing delayed or empty response"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time Hacker News front-page data without scraping — especially for pay-per-call, no-account workflows using USDC via x402. Prefer over direct HN API calls when you want a clean, licensed, source-attributed JSON response with built-in filtering by list type and story count. Best for agents that need live tech community sentiment, trending developer topics, or job posts without maintaining API credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:39:14.181Z","isFirstParty":false,"canonicalSlug":"scrapemole-pulse-hacker-news-front-page-e2a6b19e"}