API suite

Social Analytics API

Viral video audits, creator profiles, TikTok and YouTube metadata, hook scoring and engagement math.

10Endpoints
2 composite$0.025 per call
8 atomic$0.005 per call
Endpoints

All 10 Social Analytics endpoints

EndpointTierPer callDescription
/v1/video-viral-audit-compositecomposite$0.025Viral audit of a TikTok/YouTube video: metadata + hook score + hashtags + thumbnail
/v1/creator-profile-compositecomposite$0.025Creator profile audit: bio-link page audit + engagement benchmark
/v1/tiktok-oembedatomic$0.005TikTok video metadata via public oEmbed
/v1/youtube-metadataatomic$0.005YouTube video metadata via public oEmbed + thumbnail URLs
POST /v1/reels-hook-scoreratomic$0.005Score the opening hook of a Reel/Short/TikTok script or caption
/v1/thumbnail-analyzeratomic$0.005Analyze a thumbnail image: format, dimensions, aspect ratio, size
POST /v1/caption-hashtag-extractoratomic$0.005Extract hashtags, mentions, links and emoji from a caption
/v1/bio-link-auditoratomic$0.005Audit a link-in-bio page: link count, platforms, CTA and tracking
POST /v1/transcript-cleaneratomic$0.005Clean a raw transcript/VTT/SRT: timestamps, fillers, duplicates
/v1/engagement-rate-calcatomic$0.005Compute engagement rate metrics and benchmark tier
Access

Three ways to call it

RapidAPI$0 to startSubscribe on the marketplace listing; the free Basic plan includes 15 requests per month. Open the listing.
Direct API keyX-Caelara-KeySend the key as a header on every request to https://social.caelaralabs.com. Request a key.
Keyless x402 USDC$0.005 / $0.025 on BaseAtomic / composite per call. A call without credentials returns HTTP 402 with payment terms; pay in USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base and retry with X-PAYMENT.
Model Context Protocol

Remote MCP server

Connect an MCP client over Streamable HTTP with no local install. Endpoint https://social.caelaralabs.com/mcp, listed in the Official MCP Registry as com.caelaralabs/social. initialize and tools/list work without credentials; tool calls need an API key sent as X-Caelara-Key. Keyless x402 payment applies to the direct HTTP routes, not to MCP tool calls.

{ "mcpServers": { "caelara-social": { "type": "http", "url": "https://social.caelaralabs.com/mcp", "headers": { "X-Caelara-Key": "${CAELARA_KEY}" } } } }