Tools / Viral Video Clone

Analyze Video Format

Forensic breakdown of a TikTok, Instagram, or YouTube video. Extracts hook type, scene structure with timing, camera angles, transitions, text overlays, pacing rhythm, audio style. Async — returns job_id, poll with get_job_result. Takes ~60s.

Returns: Complete VideoFormat object with forensic breakdown of every production detail

Parameters

url *stringVideo URL from TikTok, Instagram, or YouTube. The tool server CAN fetch any public URL — always pass it.

platformstringPlatform the video is from. Auto-detected from URL if omitted.

Example

Analyze a TikTok video

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "viral-video-clone",
  "skill": "analyze_video",
  "input": {
    "url": "https://www.tiktok.com/@creator/video/7123456789"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Adapt Format to Brand

Adapt a forensic video analysis to a new brand, persona, and product. Preserves the exact format structure (scene count, timing, camera angles, transitions, pacing, hook type) while adapting all content. Output is compatible with ugc-content pipeline.

Returns: Production brief with scripts and scenes ready for the ugc-content pipeline

Parameters

video_format *objectThe VideoFormat object returned by analyze_video

brand_name *stringBrand or business name

product_description *stringWhat the product/service does and who it is for

target_audience *stringTarget audience description (demographics, interests, pain points)

persona_descriptionstringOn-screen persona (age, appearance, style, energy). If omitted, inferred from source video style.

key_messagesarraySpecific messaging points to communicate

platformstringTarget platform. Defaults to source video platform.

tone_overridestringOverride the source video tone if desired (e.g. "more authoritative", "casual and funny")

Example

Adapt a viral format to a skincare brand

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "viral-video-clone",
  "skill": "adapt_format",
  "input": {
    "video_format": {
      "source": {
        "url": "https://tiktok.com/example",
        "platform": "tiktok",
        "duration_seconds": 20,
        "aspect_ratio": "9:16"
      },
      "transcript": "Example transcript",
      "hook": {
        "type": "question",
        "text": "Did you know?",
        "duration_seconds": 3,
        "technique": "Curiosity gap"
      },
      "scenes": [],
      "pacing": {
        "total_scenes": 4,
        "avg_scene_duration_seconds": 5,
        "rhythm": "fast-slow-fast",
        "visual_change_frequency": "every 3s"
      },
      "audio": {
        "style": "talking_head",
        "speaking_pace_wps": 2.5,
        "tone": "casual",
        "energy_curve": "high-low-high",
        "background_music": null,
        "sound_effects": []
      },
      "cta": {
        "type": "follow",
        "text": "Follow for more",
        "position": "end"
      },
      "style": {
        "aesthetic": "raw/authentic",
        "color_mood": "warm",
        "text_style": null,
        "overall_vibe": "Casual selfie-style talking head"
      }
    },
    "brand_name": "GlowSkin",
    "product_description": "Natural vitamin C serum for radiant skin",
    "target_audience": "Women 25-35 interested in clean skincare",
    "persona_description": "28-year-old woman, casual style, warm energy"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"viral-video-clone","skill":"analyze_video","input":{}}' \
  https://api.toolrouter.com/v1/tools/call