{"uid":"cap_NUB10rXg3YNXaz765VwN8","slug":"syntalic-brand-share-of-voice-social-signals-2334f08f","name":"Syntalic Brand Share of Voice – Social Signals","description":"Social signals query - $0.03 per request","url":"https://api.syntalic.com/v1/social/brand-share?utm_source=zero.xyz","method":"POST","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","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["category"],"properties":{"brand":{"type":"string","example":"Apple","minLength":1,"description":"Brand name (e.g., Sony, Samsung, Nike)"},"limit":{"type":"integer","default":25,"example":25,"maximum":100,"minimum":1,"description":"Max results to return (default 25, min 1, max 100)"},"window":{"enum":["7d","30d","90d"],"type":"string","default":"30d","description":"Rollup window. Only published windows are accepted."},"category":{"type":"string","example":"grocery-gourmet-food","description":"Category root slug (department, not aisle)."},"platform":{"enum":["all","tiktok","instagram"],"type":"string","default":"all","description":"TikTok and Instagram are the only platforms in the corpus."},"organic_only":{"type":"boolean","default":false,"description":"Exclude posts marked as ads."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iRTW3P6PTz2RPTOHnpq7L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns social media share-of-voice metrics for a brand within a product category, aggregated from TikTok and Instagram posts over a configurable time window","exampleAgentPrompt":"What's Nike's share of voice on TikTok and Instagram in the sneaker category over the last 30 days — organic posts only, top 25 results?","exampleUseCases":[{"title":"Brand campaign social impact tracking","prompt":"Can you pull the social share of voice for Glossier in the skincare category on Instagram over the past 7 days, organic posts only, so I can see how much buzz the new campaign is generating?"},{"title":"Competitive social benchmarking","prompt":"How does Samsung's social media presence compare across all platforms in the consumer-electronics category over the last 90 days? Give me up to 50 results so I can benchmark it against the category."},{"title":"Retail category social landscape snapshot","prompt":"Show me the brand social signal breakdown for the grocery-gourmet-food category across TikTok and Instagram over the last 30 days — include ads too — so I can see which brands are dominating the conversation."}],"resultDescription":"Returns aggregated social share-of-voice data for the requested brand within the specified category and time window, including post volume and platform-level breakdowns from TikTok and/or Instagram, optionally filtered to organic (non-ad) content only.","failureModes":["Missing required 'category' parameter returns a 400 validation error","Invalid or unrecognized category slug returns an empty result set or error","Requested time window not yet published returns an error or empty response","Brand name not found in corpus returns zero or empty results","Platform filter mismatch if data for selected platform is unavailable"],"whenToPreferThis":"Choose this endpoint when you need social media share-of-voice or brand social signal data specifically tied to a product category, scoped to TikTok and/or Instagram. Prefer it over generic social listening tools when you need category-contextualized brand comparisons, time-windowed rollups, and the ability to filter organic vs. paid posts. Best suited for e-commerce and retail brand intelligence use cases on the Syntalic platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:16:27.134Z","isFirstParty":false,"canonicalSlug":"syntalic-brand-share-of-voice-social-signals-2334f08f"}