{"uid":"cap_QG0FNZ6fdVy5PtTJqS6RH","slug":"hacker-news-search-api-southpow-media-4c9e4ec0","name":"Hacker News Search API (southpow.media)","description":"Hacker News search: stories matching a keyword, newest first or top-voted, with points, comment count and links. $0.003 USDC on Base. No account, no API key.","url":"https://southpow.media/v1/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":["q"],"properties":{"n":{"type":"string","description":"Stories, 1-30 (default 10)"},"q":{"type":"string","description":"Keyword, e.g. x402"},"sort":{"type":"string","description":"recent (default) or top"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"sort":"recent","as_of":"2026-11-03T00:00:00Z","count":1,"query":"AI agents","stories":[{"url":"https://example.com","title":"Show HN: example","points":42,"posted":"2026-11-03T00:00:00Z","comments":10}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/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_fpVOJlltJxGLQmt7EVwDQ","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":"Searches Hacker News stories by keyword, returning results sorted by newest or top-voted with points, comment counts, and links.","exampleAgentPrompt":"Search Hacker News for the top 15 stories about 'LLM agents', sorted by most points.","exampleUseCases":[{"title":"Track competitor mentions on HN","prompt":"Search Hacker News for the 20 most recent stories mentioning 'Vercel' so I can see what the developer community is saying lately."},{"title":"Research trending AI topics","prompt":"Find the top 10 highest-voted Hacker News posts about 'retrieval augmented generation' — sort by top so I see what resonated most with the community."},{"title":"Monitor open-source project buzz","prompt":"Pull the 5 most recent Hacker News stories that mention 'Deno' so I can track how much attention it's getting right now."}],"resultDescription":"A JSON object containing the search query, sort mode, timestamp, story count, and an array of stories each with title, URL, points, comment count, and posted datetime.","failureModes":["Missing required 'q' parameter returns an error","'n' out of range (not 1–30) may return an error or be clamped","Invalid sort value (not 'recent' or 'top') may default or error","Payment failure (insufficient USDC balance) blocks the request","Query with no matching stories returns an empty stories array","Rate limiting if too many requests in a short window"],"whenToPreferThis":"Use this endpoint when you need to search Hacker News specifically — not the general web — for community discussion, developer sentiment, or tech news. Prefer it over general web search when you want HN-specific signals like upvote counts and comment volume, or when you want to gauge how the developer/tech community perceives a topic. It's particularly useful for tracking product launches, library releases, or technical debates that the HN audience is most likely to cover.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:41:36.647Z","isFirstParty":false,"canonicalSlug":"hacker-news-search-api-southpow-media-4c9e4ec0"}