{"uid":"cap_G0HqdNYfZFbNBtmXnWhab","slug":"stablesocial-ugc-brief-36d9a867","name":"StableSocial UGC Brief","description":"Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.","url":"https://stablesocial.dev/api/lightreel/ugc-brief","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"goal":{"type":"string","maxLength":500,"minLength":1,"description":"Campaign goal, e.g. app installs, purchases, trial starts, awareness"},"audience":{"type":"string","maxLength":500,"minLength":1,"description":"Target customer, creator persona, or audience segment"},"platform":{"enum":["any","tiktok","instagram","twitter","x","youtube","facebook","reddit"],"type":"string","default":"any","description":"Social platform to focus on"},"timeframe":{"type":"string","default":"this week","maxLength":120,"minLength":1,"description":"Time window to focus on, e.g. this week, last 30 days"},"conversation_id":{"type":"string","minLength":1,"description":"Lightreel conversation ID returned by a prior chat response"},"product_or_campaign":{"type":"string","maxLength":1000,"minLength":1,"description":"Product, brand, campaign, offer, or landing page context"}}},"responseSchema":{"type":"json","example":{"jobId":"clx0000000000000000000000","status":"pending","pollUrl":"https://stablesocial.dev/api/jobs/clx0000000000000000000000","retryAfterSeconds":5}},"example":{"request":{"query":"sustainable fashion trends","platform":"tiktok","timeframe":"this week","max_videos":10,"include_analysis":true,"product_or_campaign":"Eco-friendly apparel brand campaign"},"response":{"jobId":"cmqj4dyd0000204l4ps07q3z5","status":"pending","pollUrl":"https://stablesocial.dev/api/jobs/cmqj4dyd0000204l4ps07q3z5","retryAfterSeconds":5}},"exampleRequest":{"query":"sustainable fashion trends","platform":"tiktok","timeframe":"this week","max_videos":10,"include_analysis":true,"product_or_campaign":"Eco-friendly apparel brand campaign"},"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ht3Jlr_qCjL_6tbrEFCBS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Initiates an asynchronous job to generate a UGC (user-generated content) brief by aggregating social media data across TikTok, Instagram, Facebook, Reddit, and LinkedIn","exampleAgentPrompt":"Put together a UGC brief for the brand 'Oatly' pulling social signals from TikTok, Instagram, and Reddit — I need it for a campaign planning session.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing a jobId (unique identifier for the async job), a status field set to 'pending', a pollUrl to check when the UGC brief is ready, and a retryAfterSeconds value indicating how long to wait before polling.","failureModes":["Payment not included or insufficient — 402 payment required error","Invalid or missing request body parameters — 400 bad request","Upstream social platform rate limiting causes job failure — job status may reflect error on poll","pollUrl returns non-200 if job ID is invalid or expired","Service unavailable due to downstream social media API outages"],"whenToPreferThis":"Use this endpoint when you need a multi-platform UGC brief without subscribing to an enterprise social listening tool. It is ideal for one-off campaign research, pay-per-use workflows, or agents that need UGC insights on demand across TikTok, Instagram, Facebook, Reddit, and LinkedIn without managing auth or recurring billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:29.918Z","isFirstParty":false}