Paragon123456/tiktok-creative-analyzer

TikTok Creative Analyzer (Wavemaker MY)

Automated backend that watches a TikTok video and returns a structured 8-section creative audit. Built for the Wavemaker Malaysia biddable team.

Pipeline

1. 1.yt-dlp downloads the TikTok (video + metadata)
2. 2.ffmpeg extracts 5 frames + audio track
3. 3.Groq Llama 4 Scout analyses the frames (vision)
4. 4.Groq Whisper-large-v3 transcribes the audio
5. 5.Groq Llama 3.3 70B synthesises the 8-section audit

Setup

1. 1.In Space Settings → Variables and secrets, add:
2. 2.GROQ_API_KEY = your key from https://console.groq.com/keys
3. 3.Space rebuilds automatically.

API

POST /analyze

{ "url": "https://www.tiktok.com/@user/video/123..." }

Returns:

{
  "metadata": { "title": "...", "view_count": 12345, ... },
  "transcript": "...",
  "visual_analysis": "Frame 1 (0.8s): ...",
  "audit": {
    "hook": "...",
    "format": "...",
    "key_message": "...",
    "cta": "...",
    "audio_strategy": "...",
    "pacing": "...",
    "why_it_performs": "...",
    "applicability": "..."
  }
}