# ViralLead AI - Viral Video Content & Audio Transcriber (`automation_studio/virallead-video-transcriber`) Actor

Lightning-fast viral video content transcriber and script repurposing engine. Transcribe Instagram Reels, TikToks, YouTube Shorts, & podcasts. Extract hooks, viral scripts, virality scores, and auto-generate Twitter/LinkedIn content. Export to JSON, CSV, & Excel.

- **URL**: https://apify.com/automation\_studio/virallead-video-transcriber.md
- **Developed by:** [Asad Naeem](https://apify.com/automation_studio) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 transcribed & analyzed viral videos

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🎙️ ViralLead AI — Viral Video Content, Script & Audio Transcriber

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-orange?style=flat-square\&logo=apify)](https://apify.com)
[![Pay-Per-Event](https://img.shields.io/badge/Pricing-Pay--Per--Event-green?style=flat-square)](https://apify.com)
[![Platforms](https://img.shields.io/badge/Platforms-YouTube%20%7C%20TikTok%20%7C%20Reels%20%7C%20X-blue?style=flat-square)](#)

> **The ultimate speech-to-text transcription, viral hook extraction, and content repurposing engine for creator agencies, marketing teams, and AI video editors.**

***

### ⚡ What Does ViralLead AI Do?

**ViralLead AI** automatically processes YouTube Shorts, TikTok videos, Instagram Reels, Facebook Reels, podcasts, and Twitter/X videos to:

1. **Transcribe Speech-to-Text**: High-accuracy transcripts with timestamps using native subtitle streaming and ultra-fast Groq/OpenAI Whisper.
2. **Detect the Viral Hook**: Pinpoints the opening 3–5 seconds hook sentence and classifies its psychological persuasion angle (*Curiosity Gap, Negative/Contrarian, Direct Question, Bold Claim, Story Frame, How-To*).
3. **Calculate Virality Score (1–100)**: Evaluates hook punchiness, pacing (words per minute), emotional resonance, and retention appeal.
4. **Auto-Generate Repurposed Content**:
   - 🐦 **Twitter/X Thread**: Ready-to-tweet 4–5 post thread with viral formatting.
   - 💼 **LinkedIn Post**: Thought-leadership formatted post with whitespace and punchy hook.
   - 📧 **Newsletter Breakdown**: 3 core bullet lessons + quote for Substack / Beehiiv.
5. **Extract Creator Metadata**: Channel name, creator handle, video duration, view count, like count, and direct thumbnail URLs.

***

### 🎯 Why Choose ViralLead AI Over Traditional Transcribers?

| Feature | Generic Apify Transcribers | **ViralLead AI** |
|---|---|---|
| **Transcription Speed** | 1–3 minutes (Heavy video download) | **< 3 seconds (Stream audio & native captions)** |
| **Memory Footprint** | 4,096 MB (High cost) | **1,024 MB (75% cheaper compute)** |
| **Hook Detection** | ❌ None | ✅ **Exact 3–5s hook identified** |
| **Hook Type Classification** | ❌ None | ✅ **6 psychological angle categories** |
| **Virality Scoring** | ❌ None | ✅ **1–100 scientific retention score** |
| **Social Repurposing** | ❌ Raw unformatted text dump | ✅ **Ready-to-post Twitter & LinkedIn drafts** |
| **API Key Requirement** | Mandatory Paid Keys | **Zero required (Smart multi-tier fallback)** |
| **Pricing Model** | Expensive Monthly Rental | **Pay-Per-Event ($0.005 / analyzed video)** |

***

### 🚀 How It Works

```mermaid
graph TD
    A[Social Video URL] --> B[Fast Metadata & Stream Resolver]
    B --> C{Native Captions Available?}
    C -->|Yes: Instant 0.2s| D[Stream Native Subtitles]
    C -->|No| E[Extract Lightweight Audio Stream]
    E --> F[Groq Whisper / OpenAI Whisper]
    D --> G[Full Cleaned Transcript]
    F --> G
    G --> H[Viral Hook & Pacing Intelligence Engine]
    H --> I[Psychological Hook Classification & Virality Score]
    H --> J[Social Repurposing: Twitter + LinkedIn + Newsletter]
    I --> K[Structured Dataset: JSON / CSV / Excel / Notion]
    J --> K
```

***

### 📥 Input Configuration

| Parameter | Type | Required | Description |
|---|---|---|---|
| `videoUrls` | Array | **Yes** | List of video URLs (YouTube Shorts, TikTok, Instagram Reels, etc.). |
| `extractHookAndVirality` | Boolean | Optional | Pinpoint opening hook and calculate virality score (Default: `true`). |
| `generateRepurposedPosts` | Boolean | Optional | Auto-draft Twitter thread, LinkedIn post, & newsletter (Default: `true`). |
| `groqApiKey` | String (Secret) | Optional | Free Groq API key for sub-second Whisper transcription & Llama 3.3. |
| `geminiApiKey` | String (Secret) | Optional | Google Gemini API key for deep script takeaways. |
| `openaiApiKey` | String (Secret) | Optional | OpenAI API key for Whisper-1 speech-to-text. |
| `maxVideos` | Integer | Optional | Maximum videos to process in this run (Default: `5`). |
| `proxyConfiguration` | Object | Optional | Apify proxy configuration for geo-restricted social videos. |

***

### 📤 Sample Output Record

```json
{
  "platform": "YouTube Shorts",
  "videoId": "dQw4w9WgXcQ",
  "url": "https://www.youtube.com/shorts/3H02b5yq2Q0",
  "title": "3 Mistakes Killing Your Video Retention in 2026",
  "creator": "CreatorLab",
  "durationSeconds": 48,
  "hook": "Stop starting your videos with 'Hey guys, welcome back'.",
  "hookType": "Negative / Contrarian",
  "hookStrengthScore": 94,
  "viralityScore": 89,
  "pacingWordsPerMinute": 162,
  "fullScript": "Stop starting your videos with 'Hey guys, welcome back'. Nobody cares who you are until they care what you can give them. Here are the 3 retention rules top creators use: Rule number one, cut your first 3 seconds to zero fluff. Rule two, add visual pattern interrupts every 4 seconds. Rule three, never announce your conclusion before the call to action.",
  "keyTakeaways": [
    "Eliminate greeting fluff in the opening 3 seconds",
    "Use visual pattern interrupts every 4 seconds to reset viewer attention",
    "Delay conclusion announcements until after your primary CTA"
  ],
  "repurposedContent": {
    "twitterThread": "1/ Stop starting your videos with 'Hey guys, welcome back'.\n\nHere are 3 retention rules top creators use to hit 1M+ views: 🧵\n\n2/ 1. Cut the fluff.\nNobody cares who you are until they care what you can give them.\n\n3/ 2. Pattern interrupts every 4 seconds.\nReset attention constantly.\n\n4/ 3. Never announce your conclusion before your CTA.\nSave this thread for your next shoot!",
    "linkedInPost": "Most video creators lose 70% of viewers in the first 3 seconds.\n\nWhy? They open with:\n'Hey guys, welcome back.'\n\nHere are 3 retention principles to fix your retention curve:\n\n→ Cut greeting fluff entirely\n→ Introduce visual pattern interrupts every 4 seconds\n→ Deliver high-velocity value before your CTA\n\nWhich retention tactic has worked best for your brand?",
    "newsletterSummary": "### 💡 Creator Retention Masterclass\n- Stop opening with greetings; start with the payoff.\n- Reset dopamine with visual cuts every 4 seconds.\n- Hold conclusion momentum until after your CTA."
  },
  "subtitlesAvailable": true,
  "transcriptionEngine": "Native Captions Stream",
  "scrapedAt": "2026-09-08T01:15:00Z"
}
```

***

### 💰 Economics & Pay-Per-Event (PPE) Pricing

- **Actor Start**: **$0.002**
- **Per Analyzed Video**: **$0.005** ($5.00 per 1,000 videos)
- **Memory**: **1,024 MB** (Maximum speed, minimum server overhead)

***

### 🔗 Integrations

- **Notion**: Pipe extracted scripts and hooks directly into your content database.
- **Airtable**: Create an automated content repurposing dashboard with Make.com or Zapier.
- **Make / Zapier / n8n**: Trigger transcription whenever a new video is posted to a monitored creator profile.

# Actor input Schema

## `videoUrls` (type: `array`):

List of URLs to transcribe and analyze (YouTube Shorts, TikTok videos, Instagram Reels, Facebook Reels, podcasts).

## `extractHookAndVirality` (type: `boolean`):

Pinpoint the opening 3-5 second hook, classify its psychological hook type, and score video virality (1-100).

## `generateRepurposedPosts` (type: `boolean`):

Automatically draft ready-to-publish Twitter/X threads, LinkedIn thought-leadership posts, and newsletter bullet breakdowns.

## `maxVideos` (type: `integer`):

Maximum number of videos to download and transcribe in this run.

## `groqApiKey` (type: `string`):

Optional: For sub-second Whisper transcription and Llama 3.3 70B script analysis (Groq offers a free tier at groq.com).

## `geminiApiKey` (type: `string`):

Optional: For deep script takeaways and repurposing with Gemini 2.5 Flash.

## `openaiApiKey` (type: `string`):

Optional: For OpenAI Whisper-1 transcription and GPT analysis.

## `customCookies` (type: `string`):

Optional: Paste cookies (Netscape format) to access age-restricted or private videos.

## `proxyConfiguration` (type: `object`):

Proxy settings for bypassing YouTube, TikTok, and Instagram anti-bot checks. Uses Apify Residential Proxies by default.

## Actor input object example

```json
{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ],
  "extractHookAndVirality": true,
  "generateRepurposedPosts": true,
  "maxVideos": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing transcribed scripts, hooks, virality scores, and social posts

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "videoUrls": [
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation_studio/virallead-video-transcriber").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "videoUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"] }

# Run the Actor and wait for it to finish
run = client.actor("automation_studio/virallead-video-transcriber").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  ]
}' |
apify call automation_studio/virallead-video-transcriber --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automation_studio/virallead-video-transcriber"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jzIJkxHztNOrkacvp/builds/Lvyq5PN0ieufos7fJ/openapi.json