{"uid":"cap_B3cgod7cwNtNxJyHoujl7","slug":"syntalic-social-signals-series-b61fa946","name":"Syntalic Social Signals Series","description":"Social signals query - $0.03 per request","url":"https://api.syntalic.com/v1/social/series?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":{"weeks":{"type":"integer","default":26,"maximum":104,"minimum":1,"description":"How many trailing ISO weeks to return."},"subject":{"type":"string","example":"olipop","description":"The subject key (brand_key). Required unless subject_kind=category, where it defaults to `category`."},"category":{"type":"string","example":"grocery-gourmet-food","description":"Category root slug the subject is scoped to (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."},"subject_kind":{"enum":["brand","category"],"type":"string","default":"brand","description":"What kind of subject to chart. Brand or category only."}},"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_IsBvRjnjtjCxeEFUd2Nrm","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":"Retrieves weekly time-series social engagement data for a brand or category across TikTok and Instagram, optionally filtering by organic posts only","exampleAgentPrompt":"Pull the last 26 weeks of social signal data for Olipop in the grocery-gourmet-food category across both TikTok and Instagram, organic posts only.","exampleUseCases":[{"title":"Brand social momentum tracker","prompt":"Show me the weekly social signals for Olipop in the grocery-gourmet-food category on TikTok for the past 52 weeks — organic posts only, so I can see their earned media trend."},{"title":"Category-level social trend analysis","prompt":"Give me the social signal time series for the grocery-gourmet-food category as a whole across all platforms for the last 26 weeks — I want to see how the entire category is trending, not just one brand."},{"title":"Platform comparison for a beverage brand","prompt":"Fetch 12 weeks of social data for the brand 'liquid-death' in the beverages category, and show me TikTok separately from Instagram so I can see which platform is driving more engagement."}],"resultDescription":"Returns a time-series array of weekly social signal data points for the specified brand or category, covering the requested number of trailing ISO weeks. Each data point likely includes engagement or volume metrics segmented by platform (TikTok, Instagram, or combined), with optional filtering to organic-only posts. Useful for charting trends, identifying spikes, and benchmarking social momentum.","failureModes":["Missing required 'category' query parameter returns a validation error","Invalid or unrecognized brand key (subject) may return empty series or 404","Requesting more than 104 weeks (max) returns a schema validation error","Invalid platform enum value (not 'all', 'tiktok', or 'instagram') causes request rejection","Using HTTP methods other than GET/HEAD/DELETE (e.g. POST in the body) may be rejected by the schema wrapper","Data may be sparse or missing for niche brands with low social presence"],"whenToPreferThis":"Choose this endpoint when you need weekly time-series social engagement data for a specific brand or an entire product category on TikTok and/or Instagram. It is ideal for trend analysis, campaign performance monitoring, and benchmarking organic vs paid social volume over configurable multi-week windows. Prefer this over point-in-time social queries when you need historical trajectory rather than a snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:18:29.398Z","isFirstParty":false,"canonicalSlug":"syntalic-social-signals-series-b61fa946"}