{"openapi":"3.0.3","info":{"title":"Caelara Labs Social Suite","description":"Short-form video and creator analytics: TikTok/YouTube metadata via public oEmbed, hook scoring, thumbnail analysis, hashtag extraction, bio-link audits, transcript cleaning and engagement math, plus viral-audit and creator-profile composites.","version":"1.0.0","contact":{"email":"ops@caelaralabs.com","url":"https://caelaralabs.com"}},"servers":[{"url":"https://social.caelaralabs.com"}],"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Proxy-Secret"},"CaelaraKey":{"type":"apiKey","in":"header","name":"X-Caelara-Key"},"x402USDC":{"type":"http","scheme":"bearer","description":"x402 USDC payment on Base network"}}},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/video-viral-audit-composite":{"get":{"summary":"Viral audit of a TikTok/YouTube video: metadata + hook score + hashtags + thumbnail","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"TikTok or YouTube video URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/creator-profile-composite":{"get":{"summary":"Creator profile audit: bio-link page audit + engagement benchmark","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Link-in-bio or profile page URL","schema":{"type":"string"}},{"name":"followers","in":"query","required":false,"description":"Follower count","schema":{"type":"integer"}},{"name":"avg_likes","in":"query","required":false,"description":"Average likes per post","schema":{"type":"integer"}},{"name":"avg_comments","in":"query","required":false,"description":"Average comments per post","schema":{"type":"integer"}},{"name":"avg_views","in":"query","required":false,"description":"Average views per post","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/tiktok-oembed":{"get":{"summary":"TikTok video metadata via public oEmbed","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/youtube-metadata":{"get":{"summary":"YouTube video metadata via public oEmbed + thumbnail URLs","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"YouTube video URL or id","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/reels-hook-scorer":{"post":{"summary":"Score the opening hook of a Reel/Short/TikTok script or caption","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Script or caption (first lines matter most)"}},"required":["text"]}}}}}},"/v1/thumbnail-analyzer":{"get":{"summary":"Analyze a thumbnail image: format, dimensions, aspect ratio, size","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Image URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/caption-hashtag-extractor":{"post":{"summary":"Extract hashtags, mentions, links and emoji from a caption","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caption":{"type":"string","description":"Post caption"}},"required":["caption"]}}}}}},"/v1/bio-link-auditor":{"get":{"summary":"Audit a link-in-bio page: link count, platforms, CTA and tracking","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Bio link page URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/transcript-cleaner":{"post":{"summary":"Clean a raw transcript/VTT/SRT: timestamps, fillers, duplicates","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transcript":{"type":"string","description":"Raw transcript text"}},"required":["transcript"]}}}}}},"/v1/engagement-rate-calc":{"get":{"summary":"Compute engagement rate metrics and benchmark tier","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"followers","in":"query","required":true,"description":"Follower count","schema":{"type":"integer"}},{"name":"likes","in":"query","required":true,"description":"Likes","schema":{"type":"integer"}},{"name":"comments","in":"query","required":false,"description":"Comments","schema":{"type":"integer"}},{"name":"shares","in":"query","required":false,"description":"Shares","schema":{"type":"integer"}},{"name":"saves","in":"query","required":false,"description":"Saves","schema":{"type":"integer"}},{"name":"views","in":"query","required":false,"description":"Views","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}}}}