{"uid":"cap_f9G3foRyIx4q2s5cas2cL","slug":"social-mentions-sentiment-b9078cb9","name":"Social Mentions & Sentiment","description":"Social Mentions & Sentiment: daily mention counts, distinct authors and mean VADER sentiment for a brand, product or topic over the last 1-7 days, plus the top 10 co-occurring terms. Sources: Bluesky and Hacker News, plus Reddit and X (latest, newest first) when available. One page per source: days beyond its reach come back truncated (coverage_from). Aggregate only, no text, no authors; a day under 20 known authors is suppressed. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/social/mentions?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","maxLength":100,"description":"Brand, product or topic (1-100 characters)."},"days":{"type":"string","pattern":"^[0-9]{1,4}$","description":"UTC days ending today, 1-7. Default 7."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"days":[{"date":"2026-10-09","authors":null,"mentions":null,"sentiment":null,"truncated":true,"suppressed":false},{"date":"2026-10-10","authors":null,"mentions":null,"sentiment":null,"truncated":true,"suppressed":false},{"date":"2026-10-11","authors":null,"mentions":null,"sentiment":null,"truncated":true,"suppressed":false},{"date":"2026-10-12","authors":null,"mentions":null,"sentiment":null,"truncated":true,"suppressed":false},{"date":"2026-10-13","authors":null,"mentions":null,"sentiment":null,"truncated":true,"suppressed":false},{"date":"2026-10-14","authors":null,"mentions":null,"sentiment":null,"truncated":false,"suppressed":true},{"date":"2026-10-15","authors":0,"mentions":0,"sentiment":null,"truncated":false,"suppressed":false}],"as_of":"2026-10-15T12:00:00.000Z","items":[],"query":{"q":"synthetic widgets","days":7,"sources":["bluesky","hackernews","x","reddit"]},"source":"public data via the Bluesky AppView API; not affiliated with Bluesky; public data via the Hacker News API (Algolia search and Firebase); not affiliated with Y Combinator; public data via third-party provider; not affiliated with the platform","complete":false,"platform":"multi","platforms":["bluesky","hackernews","x","reddit"],"top_terms":[],"disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":null,"coverage_from":"2026-10-14T00:00:00.000Z","total_mentions":0,"platforms_missing":[],"suppressed_buckets":1}},"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_POzMvQyP-SdHbgI2LG8nZ","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":"Returns daily mention counts, distinct author counts, and mean VADER sentiment for a brand, product, or topic over the last 1-7 days, plus the top 10 co-occurring terms, aggregated across Bluesky, Hacker News, Reddit, and X.","exampleAgentPrompt":"What's the daily mention count and sentiment for 'OpenAI' across Bluesky, Hacker News, Reddit, and X over the last 7 days, and what are the top co-occurring terms?","exampleUseCases":[{"title":"Product launch buzz tracking","prompt":"Can you pull the daily mention counts and sentiment scores for 'Notion AI' across Bluesky, Hacker News, Reddit, and X for the past 5 days so I can see how our launch is landing?"},{"title":"Competitor brand monitoring","prompt":"How is 'Anthropic' being mentioned across social platforms like Bluesky, Reddit, and Hacker News over the last 7 days — give me daily counts, sentiment, and the top terms people associate with it."},{"title":"Crisis sentiment check","prompt":"There's been some controversy around 'CrowdStrike' — can you show me daily mention volumes and mean sentiment from the last 3 days across Bluesky, Hacker News, and Reddit so I can gauge public reaction?"}],"resultDescription":"A JSON object containing: an array of daily buckets (each with date, mention count, distinct author count, mean VADER sentiment, truncated flag, and suppressed flag); total mention count; top 10 co-occurring terms; coverage start date; list of platforms queried; missing platforms; request ID; and aggregate metadata. Days with fewer than 20 known authors are suppressed and returned as null. Days beyond a source's historical reach are returned with truncated=true.","failureModes":["Query term not found on any platform — returns zero mentions and empty top_terms, not charged","Days parameter out of range (>7 or non-numeric) — bad input is free but results may be empty","Source platform temporarily unavailable — affected platform listed in platforms_missing","Day suppressed due to fewer than 20 known authors — bucket returned with null values and suppressed=true","Coverage gap for older days — truncated=true returned for days beyond a source's reach"],"whenToPreferThis":"Choose this endpoint when you need aggregate social listening data across multiple platforms (Bluesky, Hacker News, Reddit, X) with sentiment scoring and no individual-level data exposure. It is ideal for brand monitoring, product launch tracking, or competitive intelligence where daily trend lines matter more than individual posts. Prefer it over raw search endpoints when you want pre-aggregated counts, VADER sentiment, and co-occurrence analysis in a single call without handling raw text or author data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:31.890Z","isFirstParty":false,"canonicalSlug":"social-mentions-sentiment-b9078cb9"}