{"uid":"cap_DkXYp-bNKlqIjJMM6_g1O","slug":"stablesocial-lightreel-video-search-ec0ec622","name":"StableSocial Lightreel Video Search","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/video-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","maxLength":1000,"minLength":1,"description":"Video search brief, account, URL, topic, trend, or criteria"},"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"},"max_videos":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"Maximum number of videos to return"},"conversation_id":{"type":"string","minLength":1,"description":"Lightreel conversation ID returned by a prior chat response"},"include_analysis":{"type":"boolean","default":true,"description":"Whether to explain why each video is relevant or working"}}},"responseSchema":{"type":"json","example":{"jobId":"clx0000000000000000000000","status":"pending","pollUrl":"https://stablesocial.dev/api/jobs/clx0000000000000000000000","retryAfterSeconds":5}},"example":{"request":{"query":"artificial intelligence trends","platform":"any","timeframe":"this week","max_videos":10,"include_analysis":true},"response":{"jobId":"cmqah2bw6000004jyqewchcrl","status":"pending","pollUrl":"https://stablesocial.dev/api/jobs/cmqah2bw6000004jyqewchcrl","retryAfterSeconds":5}},"exampleRequest":{"query":"artificial intelligence trends","platform":"any","timeframe":"this week","max_videos":10,"include_analysis":true},"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_XDRvs0bC-wzkhf5jIr0Y7","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":"Searches for videos across social media platforms (TikTok, Instagram, etc.) and returns a job ID for async result polling, with pay-per-request pricing via x402.","exampleAgentPrompt":"Search StableSocial's Lightreel video search for TikTok videos about 'matcha latte recipes' and give me the top results.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing a jobId (unique async job identifier), a status field (initially 'pending'), a pollUrl to check for completed results, and a retryAfterSeconds value indicating how long to wait before polling again.","failureModes":["Payment not provided or insufficient USDC — x402 payment required error","Invalid or missing search query — 400 bad request","Job ID not found when polling — 404 error on pollUrl","Platform rate limiting or data unavailability — job may fail or return empty results","Polling timeout if job takes too long to complete"],"whenToPreferThis":"Use this endpoint when you need to search for videos across social media platforms (especially TikTok/Instagram) without committing to a subscription — ideal for one-off or low-frequency video discovery tasks where pay-per-request ($0.06 USDC) makes sense. Prefer this over scraping solutions when you need structured async results with a polling pattern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:43:06.258Z","isFirstParty":false}