{"uid":"cap_xC17Z-BtvnBknIOJ5mlHU","slug":"pennyrail-hacker-news-search-front-page-f05358bc","name":"PennyRail Hacker News Search & Front Page","description":"Search Hacker News stories/comments or fetch front-page results from the public Algolia HN index. Returns titles, URLs, authors, points, comments and timestamps as clean JSON. Exact-match PennyRail gap-arbitrage route.","url":"https://pennyrail.vercel.app/api/bazaar/hacker-news","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Input for Hacker News stories and full-text search.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ocvGQdqiCZLz7hTNJlUiz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Hacker News stories and comments or fetch current front-page results via the Algolia HN index, returning clean JSON with titles, URLs, authors, points, comment counts, and timestamps.","exampleAgentPrompt":"Search Hacker News for the most recent stories about large language models and give me the titles, links, points, and comment counts.","exampleUseCases":[{"title":"Daily tech news briefing","prompt":"Grab the current Hacker News front page and summarize the top 10 stories with their titles, links, and point counts for my morning briefing."},{"title":"Research HN discussions on a topic","prompt":"Search Hacker News for stories and comments about Rust programming language from the past week — I want to see what the community is saying, including authors and timestamps."},{"title":"Track a startup or product on HN","prompt":"Find all Hacker News stories and comments that mention 'Anthropic' and return the titles, URLs, points, and number of comments so I can see how they're being covered."}],"resultDescription":"Returns a clean JSON object containing a list of Hacker News items, each with story title, URL, author username, point score, comment count, and Unix timestamp. For front-page requests, returns the current top stories; for search requests, returns ranked matches from the Algolia HN full-text index.","failureModes":["Query string missing or malformed body — returns 400-level error","Algolia HN index temporarily unavailable — upstream timeout or 5xx","No results found for obscure or misspelled query — returns empty hits array","Rate limiting or payment failure due to x402 protocol issues — returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable Hacker News data — either front-page stories or full-text search — without scraping HTML. It is preferable to raw Algolia HN API calls when operating within the x402 micropayment ecosystem on PennyRail's bazaar, since it normalises results to clean JSON and handles authentication transparently.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:11:47.170Z","isFirstParty":false}