viral-scout docs
| Doc | For |
|---|---|
| Video quality framework | The 5 tests, 20 criteria and the 100-point scorecard, structure, production standards, testing, and what each one is measured with |
| Marketing workflow | Using viral-scout every week: from "what's viral" to a filmed video |
| Your performance | Your own videos and ads: hook rate, retention, CTR, CPA, ROAS from official APIs or your exports; diagnostics and the 5 tests |
| Originality and duplicate detection | How Instagram, TikTok and YouTube detect reposts and copies, what happens, and how to stay original |
| Ads scout | The paid side: long-running competitor ads, offers and hooks (Meta, TikTok, Google), coverage per region, scoring |
| Dashboard | The web UI: local with actions, or published read-only on Vercel (free) |
| How it works | Pipeline, sources, scoring formulas, data model, limits |
| Setup and keys | Install, .env, the YouTube / Instagram / Apify / Telegram keys, scheduling |
| Profiles | Writing a profile for a new business; tuning filters |
| References | Every competitor, API, library, policy and fact source, with links |
| Similar tools | How other viral/outlier tools work and what we took from them |