{"uid":"cap_RYUDaLiNUL7ESjlfi6nu1","slug":"aiworker-social-mentions-search-009f95df","name":"aiworker Social Mentions Search","description":"Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1","url":"https://aiworker.duckdns.org/v1/social/mentions","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hours":{"type":"integer","default":48,"maximum":168,"minimum":1,"description":"Only mentions published within the last N hours (default 48)."},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"Maximum mentions to return, newest first (default 20)."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Topic to look for, matched whole-word and case-insensitively against post text (and Polymarket event titles)."}}},"responseSchema":{"type":"json","example":{"items":[{"url":"https://news.ycombinator.com/item?id=43211234","kind":"story","text":"Keystone's independent analysis of the Coldcard exploit","event":null,"author":"anon84","points":87,"source":"hackernews","published":"2026-09-11T14:02:00.000Z"},{"url":"https://polymarket.com/event/fed-decision-in-september-762","kind":"comment","text":"if the fed holds, bitcoin rips","event":{"slug":"fed-decision-in-september-762","title":"Fed decision in September?"},"author":"Sandy-Evaluator-Speedboat","points":null,"source":"polymarket","published":"2026-09-11T12:10:17.000Z"}],"query":"bitcoin","counts":{"hackernews":1,"polymarket":1},"sources":[{"ok":true,"url":"https://hn.algolia.com/api/v1/search_by_date","name":"hackernews"},{"ok":true,"url":"https://gamma-api.polymarket.com/comments","name":"polymarket"}],"disclaimer":"…","attribution":"…","generated_at":"2026-09-11T20:00:00.000Z","window_hours":48}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8NY0FsVGKXDg7siQ4vzD8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Hacker News and Polymarket for recent posts and comments matching a topic, returning ranked mentions with source attribution and event context","exampleAgentPrompt":"Search for recent mentions of 'Ethereum' across Hacker News and Polymarket from the last 24 hours — give me up to 30 results, newest first.","exampleUseCases":[{"title":"Pre-trade sentiment check on a token","prompt":"Before I buy this token, can you pull the last 48 hours of Hacker News and Polymarket chatter mentioning 'Solana' — up to 25 results — so I can see what the community is saying?"},{"title":"Monitor prediction market commentary","prompt":"What are prediction market traders saying about the Fed decision right now? Search 'Fed rate' mentions from the past 12 hours across Polymarket and Hacker News."},{"title":"Track breaking crypto news discussion","prompt":"Has Coldkey been discussed on Hacker News or Polymarket in the last 6 hours? Show me up to 20 mentions so I can gauge community reaction."}],"resultDescription":"A JSON object containing an array of mention items (each with URL, source, author, text snippet, points, published timestamp, and optional Polymarket event metadata), a per-source mention count breakdown, source health status for each upstream API, the query echo, the time window used, and generated/disclaimer attribution fields.","failureModes":["Upstream Hacker News or Polymarket API unavailable — source marked ok:false in the sources array","Query too short (under 2 chars) or too long (over 120 chars) — validation error returned","hours out of range (must be 1–168) — request rejected","limit out of range (must be 1–50) — request rejected","No matching mentions found — items array is empty with valid source statuses","Payment not confirmed via x402 — request not processed"],"whenToPreferThis":"Choose this endpoint when you need real-time community and prediction-market sentiment for a specific topic aggregated from Hacker News and Polymarket in a single call. It is ideal for crypto, DeFi, and macro-event monitoring where you want both technical-community (HN) and prediction-market (Polymarket) perspectives together. Prefer it over generic web search when you want structured, ranked results with point scores, source attribution, and event context rather than raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:08.981Z","isFirstParty":false}