{"uid":"cap_rl40Tzn_SzqDDPgJHGsQC","slug":"scrapemole-social-hacker-news-full-text-search-040352b3","name":"ScrapeMole Social: Hacker News Full-Text Search","description":"Pay-per-call public social data for agents: Telegram public channel posts; Mastodon hashtag timelines; Bluesky post search, profiles and author feeds; Hacker News full-text search and threads with comments; Lobsters hottest stories. Official public APIs only, no logins, no private data. USDC via x402, no accounts; failed calls are never charged.\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://social.scrapemole.workers.dev/terms","url":"https://social.scrapemole.workers.dev/v1/hn/search?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":{"q":{"type":"string","examples":["x402"],"description":"Search text."},"days":{"type":"string","description":"Only items from the last N days (1-3650)."},"sort":{"type":"string","default":"relevance","description":"\"relevance\" or \"date\"."},"type":{"type":"string","default":"story","description":"\"story\" or \"comment\"."},"limit":{"type":"string","default":"20","description":"Max hits (1-50)."},"minPoints":{"type":"string","description":"Minimum points (stories)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"hits":[{"id":"45000000","url":"https://…","type":"story","hnUrl":"https://news.ycombinator.com/item?id=45000000","title":"…","points":120,"comments":45}],"count":1,"query":"x402"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KuXkRscEkGvSNXQttmQWY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 by keyword with filtering by recency, sort order, type, points, and result count","exampleAgentPrompt":"Search Hacker News for stories about the x402 payment protocol from the last 30 days, sorted by relevance, and show me the top 10 results with at least 10 points.","exampleUseCases":[{"title":"Track tech community buzz on a topic","prompt":"Search Hacker News for stories mentioning 'WebAssembly' from the last 14 days, sorted by date, and give me up to 20 results so I can see how the community is reacting."},{"title":"Find high-quality HN posts for research","prompt":"Find the top 5 Hacker News stories about 'large language models' with at least 50 points — I want the most upvoted, authoritative community discussions."},{"title":"Monitor competitor or product mentions","prompt":"Search Hacker News for any stories or comments mentioning 'Supabase' from the last 7 days, sorted by relevance, limit to 15 results."}],"resultDescription":"Returns a JSON object with a hits array of matching HN items (each with id, url, type, hnUrl, title, points, and comment count), total count, and the echoed query string. Up to 50 results per call.","failureModes":["Missing required 'q' parameter returns a 400 error and no charge","Invalid sort value (not 'relevance' or 'date') may return an error or default behavior","Invalid type value (not 'story' or 'comment') may be rejected","Limit out of range (outside 1-50) may be clamped or rejected","Days out of range (outside 1-3650) may be rejected","Payment failure via x402 results in no call being made and no charge","Upstream Algolia HN Search API downtime may cause 502/503 responses","Very niche or rare queries may return zero hits with an empty hits array"],"whenToPreferThis":"Use this endpoint when you need to search the Hacker News corpus by keyword — especially for tech, startup, or developer-community topics. Prefer it over general web search when you specifically want the HN community's perspective, upvoted stories, or threaded discussions. It pays per call in USDC with no account required, making it suitable for agent workflows that need lightweight, on-demand HN search without a subscription. Best for queries where recency (days filter) and community quality signal (minPoints) matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:41:19.312Z","isFirstParty":false,"canonicalSlug":"scrapemole-social-hacker-news-full-text-search-040352b3"}