# Video Breakdown for Reels & TikTok: Hook, Script, Scenes, CTA (`tenfoldfleet/video-breakdown-hook-analysis`) Actor

Analyze the hook of a TikTok, Instagram Reel or Facebook video: opening line, hook type and score, script, scene-by-scene shot list with keyframes and on-screen text, CTA, pacing and 3 new hook ideas, as JSON. $28 per 1,000 videos (1 min), $0.008 per extra minute; failed videos are free.

- **URL**: https://apify.com/tenfoldfleet/video-breakdown-hook-analysis.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Videos, AI, Social media
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $14.00 / 1,000 video analyzeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Video Breakdown for Reels & TikTok do?

**Video Breakdown for Reels & TikTok** takes a short social video and tells you how it is built. Paste a **TikTok video, Instagram Reel or Facebook reel** link (or a direct MP4 file) and get back one structured record: the **hook** (opening line, on-screen text, what the viewer sees, hook type and a 1-10 score), the full **script**, a **scene-by-scene shot list** with keyframe images and on-screen text, the **call to action**, measured **pacing** (cuts per minute, words per minute, time to first word) and three fresh hook lines written in the same style.

It works as a **video analysis API**: run it from Apify Console, call it over the Apify API, schedule it, or hand it to an AI agent. No TikTok or Instagram account, cookies or login are needed.

> Not affiliated with TikTok, ByteDance, Instagram or Meta. TikTok, Instagram and Facebook are trademarks of their owners.

### Why use a video breakdown tool?

- **Creative research:** see why a competitor's reel got attention: what the first 2 seconds show, which hook device it uses, where the CTA lands.
- **Content briefs:** turn 20 top videos in a niche into a table of hooks, formats and beats you can hand to an editor or a UGC creator.
- **Ad testing:** compare the hooks of winning and losing ads side by side with the same scoring.
- **Script writing:** reuse the beat structure (hook, setup, value, proof, CTA) and the suggested hook variations as a starting point.
- **AI workflows:** feed clean JSON to ChatGPT, Claude or your own pipeline instead of raw video.

### What data can it extract?

![Sample output of Video Breakdown for Reels & TikTok: Hook, Script, Scenes, CTA, rows from a real run: Video, Creator, Seconds, Format, Topic, Summary](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/video-breakdown-hook-analysis-output.png)

| Field | What you get |
|---|---|
| `hook` | `spokenLine`, `onScreenText`, `visual`, `type` (question, bold-claim, curiosity-gap, story, demonstration...), `technique`, `strength` (1-10), `why` |
| `script` | Full transcript of the speech (speech recognition), plus `transcriptSegments` with timestamps |
| `scriptBeats` | Ordered beats with start/end seconds: hook, setup, problem, value, proof, story, demo, payoff, CTA... |
| `scenes` | Shot list: start, end, shot type (close-up, wide, screen recording, text card...), description, on-screen text, people count, keyframe image URL |
| `cta` | Whether there is a call to action, its words, type (follow, comment, link-in-bio, buy...) and when it appears |
| `pacing` | Scene cuts, cuts per minute, average shot length, words per minute, first spoken word, share of the video with speech |
| `format`, `topic`, `niche`, `tone`, `targetAudience`, `summary` | How the video is made and who it is for |
| `hookVariations`, `strengths`, `improvements` | Three new opening lines, what works, and concrete fixes |
| Metadata | `videoUrl`, `platform`, `author`, `caption`, `videoDurationSec`, `analyzedSec` |

### How to break down a TikTok or Reel

1. Open the Actor in Apify Console and click **Try for free**.
2. Paste one or more video links into **Videos** (TikTok, Instagram Reel, Facebook reel, or a direct .mp4/.mov/.webm/.m3u8 file).
3. Optional: pick the **Analysis language** (English by default) and the **Max minutes per video**.
4. Click **Start**. Each video takes about 20-60 seconds.
5. Open the **Breakdowns** table, or download the full results as JSON, CSV or Excel.

### How much does it cost?

Pay per result, no subscription:

- **$0.028 per video analyzed** ($28 per 1,000 videos), the first minute of the video included.
- **$0.008 per extra started minute** after the first one (a 61-second reel is one minute; a 2:30 video is the video price plus 2 extra minutes).
- **Failed videos are free**: private, deleted or unreadable videos come back as a row with an `error` field and no charge.
- **Free Apify plan:** up to 5 videos per run, each analyzed up to 3 minutes.

Set a maximum cost per run in Console and the Actor stops before it goes over.

### Input

```json
{
    "videos": [
        "https://www.tiktok.com/@thatdudecancook/video/7649086431641521421",
        "https://www.instagram.com/reel/DRFN52TiK3L/"
    ],
    "maxDurationMinutes": 3,
    "outputLanguage": "English",
    "transcriptLanguage": "auto",
    "includeTranscriptSegments": true,
    "saveKeyframes": true
}
```

### Output

One record per video (shortened):

```json
{
    "videoUrl": "https://www.tiktok.com/@thatdudecancook/video/7649086431641521421",
    "platform": "TikTok",
    "author": "thatdudecancook",
    "videoDurationSec": 69.54,
    "hook": {
        "spokenLine": "If your thing is spicy pasta, then I have got you covered.",
        "visual": "A person stands in a kitchen and talks while gesturing towards a pan on a stove.",
        "type": "demonstration",
        "strength": 9,
        "why": "Immediately shows the video's value with a confident, specific claim about spicy pasta"
    },
    "format": "tutorial",
    "topic": "Spicy pasta recipe",
    "scriptBeats": [
        { "start": 0, "end": 3.7, "beat": "hook", "summary": "Creator promises a fix for spicy pasta lovers" },
        { "start": 3.9, "end": 6.2, "beat": "setup", "summary": "Explains the first step of seasoning pasta water" }
    ],
    "scenes": [
        { "index": 1, "start": 0, "end": 1.8, "shotType": "medium", "description": "A person stands in a kitchen and talks while gesturing towards a pan on a stove.", "onScreenText": "", "frameUrl": "https://api.apify.com/v2/key-value-stores/.../records/001-...-shot01.jpg" }
    ],
    "cta": { "present": false, "text": null, "type": null, "atSec": null },
    "pacing": { "sceneCuts": 12, "cutsPerMinute": 10.35, "avgShotSec": 5.35, "wordsPerMinute": 238, "firstWordAtSec": 0, "speechSharePct": 80 },
    "hookVariations": ["Spicy pasta fans, this one's for you.", "Got a craving for spicy pasta? I've got the solution.", "If you love spicy pasta, I've got the perfect recipe for you."],
    "script": "If your thing is spicy pasta, then I have got you covered. And you want to start by seasoning up your pasta water..."
}
```

Download the dataset as JSON, CSV, Excel, XML or HTML, or read it through the Apify API.

### Tips

- Short videos (under a minute) cost one video event; set **Max minutes per video** to 1 to cap the price of longer ones.
- Music-only videos work: the script is empty (`hasSpeech: false`) and the breakdown relies on the visuals and on-screen text.
- Set **Analysis language** to your team's language; quotes of speech and on-screen text stay in the video's own language.
- Turn off **Save keyframe images** if you only need the text.

### Use it with AI agents (MCP)

Give Claude, ChatGPT, Cursor or any MCP client this Actor as a tool through Apify's MCP server: add `https://mcp.apify.com?tools=tenfoldfleet/video-breakdown-hook-analysis` as a remote MCP server and sign in with your Apify account. The agent passes the video links, runs the Actor and reads the breakdowns itself; you pay the same per-event price as a normal run.

### FAQ

#### Which platforms are supported?

Public TikTok videos, Instagram Reels and video posts, Facebook reels and videos, and direct video files (.mp4, .mov, .webm, .m3u8). YouTube links are not supported, because YouTube blocks video downloads from cloud servers.

#### Do I need an account, cookies or a login?

No. Only public videos that anyone can watch without logging in are analyzed.

#### How is the hook scored?

An AI model reads the opening line, the first frames and the on-screen text and rates how likely the opening is to stop a scroll, from 1 to 10, with a one-sentence reason. Scene cuts, speech timing and words per minute are measured from the video itself, not guessed.

#### Which languages work?

Speech recognition detects about 100 languages automatically. The written analysis is in the language you choose.

#### What happens with private or deleted videos?

They return a row with an `error` field and are not charged.

#### Is it legal to analyze social videos?

The Actor only reads publicly available videos. You are responsible for how you use the results, including copyright and the platforms' terms. Do not republish other creators' content without permission.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [Video Transcriber - Any Link to Text, SRT & VTT (7 Platforms)](https://apify.com/tenfoldfleet/video-transcriber-any-url) | video transcribed |
| [Bilibili Transcript - Video to Text with SRT & Translation](https://apify.com/tenfoldfleet/bilibili-transcript-video-to-text) | video transcript |
| [YouTube Video Details Lookup: Views, Likes & Tags by URL](https://apify.com/tenfoldfleet/youtube-video-details-lookup) | video details |
| [Instagram Video Downloader - Reels & Posts to MP4, MP3](https://apify.com/tenfoldfleet/instagram-video-downloader-reels-posts) | video saved |
| [Snapchat Transcript - Spotlight & Story Video to Text](https://apify.com/tenfoldfleet/snapchat-transcript-spotlight-video-to-text) | video transcript |
| [Twitter Video Transcript - X Video to Text & SRT](https://apify.com/tenfoldfleet/twitter-video-transcript) | video transcript |
| [Stock Photos & Videos Scraper for Pexels](https://apify.com/tenfoldfleet/stock-photos-scraper) | media item |
| [YouTube Livestream & Channel Scraper - Videos, Likes & Stats](https://apify.com/tenfoldfleet/youtube-channel-scraper) | video |
| [YouTube Comments API & Scraper - Replies, Likes & Newest First](https://apify.com/tenfoldfleet/youtube-comments-scraper) | comment |
| [YouTube Rank Checker - Keyword Positions for Videos & Channels](https://apify.com/tenfoldfleet/youtube-rank-checker) | keyword check |
| [YouTube Search Scraper: Keyword Video & Shorts Monitor](https://apify.com/tenfoldfleet/youtube-search-scraper) | search result |
| [YouTube Shorts Analytics Scraper - Views, Likes & Hashtags](https://apify.com/tenfoldfleet/youtube-shorts-scraper) | short |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/video-breakdown-hook-analysis/changelog.md

# Actor input Schema

## `videos` (type: `array`):

Links to the videos to break down: TikTok videos (https://www.tiktok.com/@user/video/123...), Instagram reels, Facebook reels, or direct .mp4, .mov, .webm or .m3u8 files. One video = one result. YouTube links are not supported. Free Apify plan: up to 5 videos per run.

## `maxDurationMinutes` (type: `integer`):

Only the first N minutes of each video are analyzed (1 to 10). The first minute is in the video price; each extra started minute is billed as an extra minute. Free Apify plan: up to 3 minutes.

## `outputLanguage` (type: `string`):

Language for the written analysis (hook notes, summary, beats, suggestions), for example English, Spanish or German. Spoken words and on-screen text are always quoted as they are.

## `transcriptLanguage` (type: `string`):

Two-letter code of the language spoken in the videos (en, es, de...) to help speech recognition. Leave 'auto' to detect it.

## `includeTranscriptSegments` (type: `boolean`):

Add the transcript as timestamped sentences (transcriptSegments).

## `saveKeyframes` (type: `boolean`):

Save one JPG per scene and link it in each scene (frameUrl).

## `maxConcurrency` (type: `integer`):

How many videos to analyze at the same time.

## Actor input object example

```json
{
  "videos": [
    "https://www.tiktok.com/@thatdudecancook/video/7649086431641521421"
  ],
  "maxDurationMinutes": 3,
  "outputLanguage": "English",
  "transcriptLanguage": "auto",
  "includeTranscriptSegments": true,
  "saveKeyframes": true,
  "maxConcurrency": 4
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "videos": [
        "https://www.tiktok.com/@thatdudecancook/video/7649086431641521421"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/video-breakdown-hook-analysis").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 = { "videos": ["https://www.tiktok.com/@thatdudecancook/video/7649086431641521421"] }

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/video-breakdown-hook-analysis").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 '{
  "videos": [
    "https://www.tiktok.com/@thatdudecancook/video/7649086431641521421"
  ]
}' |
apify call tenfoldfleet/video-breakdown-hook-analysis --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/video-breakdown-hook-analysis"
        }
    }
}
```

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/yylCoOLYkxz34fjpj/builds/1fYbZeUV5LIExd2Kc/openapi.json
