# TikTok Ad 3-Second Visual Hook Analyzer & Cloner (`w80757983/tiktok-ad-3s-visual-hook-analyzer`) Actor

TikTok Ad 3-Second Visual Hook Analyzer & Cloner. Powered by Gemini 3.8 Flash & Gemini 4 Argon Vision. Built for TikTok Shop Sellers, Dropshippers & Performance Ad Agencies.

- **URL**: https://apify.com/w80757983/tiktok-ad-3s-visual-hook-analyzer.md
- **Developed by:** [Wang Yun](https://apify.com/w80757983) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## TikTok Ad 3-Second Visual Hook Analyzer & Cloner

**Stop losing 80% of your viewers in the first 3 seconds.** Most "video script scrapers" only transcribe audio text—they are completely blind to the visual composition, lighting contrast, camera cuts, and facial micro-expressions that actually stop the scroll.

**TikTok Ad 3-Second Visual Hook Analyzer & Cloner** extracts the exact first **3.0 seconds (9 frames at 3 FPS)** into a high-resolution **3×3 Contact Sheet**, runs a live multimodal vision audit powered by **Google Gemini 3.8 Flash & Gemini 4 Argon**, and outputs **3 ready-to-copy storyboard & AI video generation prompts (Kling / Sora 2 / Runway / Veo / Jimeng)** so you can clone winning hooks in minutes.

### Built For

- **TikTok Shop Sellers, Dropshippers & Performance Ad Agencies**
- **Automation Builders**: Native compatibility with **Apify MCP Server**, **Claude Desktop**, **Cursor**, **n8n**, **Make.com**, and **Feishu Bitable / Notion**.
- **Search Tags**: `TikTok Ad Spy, Visual Hook Extractor, First 3 Seconds Retention, TikTok Creative Center, UGC Script Generator`

### What You Get Per Video (Output Schema)

1. **`is_live_ai_analysis` & `model_used`**: Explicit verification that your 9-frame contact sheet was analyzed live by `gemini-3.8-flash` / `gemini-4-argon`.
2. **`hook_score_card`**: Quantitative 0–100 scores for Visual Contrast, Curiosity Gap, Pacing Density, and Estimated 3-Second Retention Rate (`%`).
3. **`frame_by_frame_breakdown`**: Second-by-second (`0.0s–1.0s`, `1.0s–2.0s`, `2.0s–3.0s`) diagnosis of Shot Type, Camera Movement, Visual Anchor, and Psychological Trigger.
4. **`de_ai_realism_secrets`**: Actionable prompt engineering rules to eliminate the "plastic AI look" and inject realistic handheld micro-shakes, skin textures, and background clutter.
5. **`one_click_clone_prompts`**: Ready-to-use clone prompts tailored for E-Commerce Ads, Micro-Dramas, and Viral TikTok/Reels UGC.
6. **`apify_contact_sheet_key`**: A 3×3 timestamped visual grid (`0.00s` to `2.67s`) saved directly in your Apify Key-Value Store for instant visual inspection.

### Transparent Pay-Per-Event (PPE) Pricing & Math

We use Apify's fair **Pay-Per-Event (PPE)** model (built-in vision model tokens included—no external API key required!):

- **Event Price (`hook-analyzed`)**: **`$0.015 USD`** per successfully analyzed video.
- **Zero Charge on Failures**: If a video URL is broken or fails extraction, you are charged **$0.00**.
- **Worked Cost Example**:
  - Analyzing **100 videos** = `100 × $0.015 = $1.50 USD` (+ ~$0.05 Apify platform compute).
  - Apify's free tier (**$5.00/month free credit**) lets you analyze **~333 videos every month for FREE** without a credit card!

### Use Directly Inside Claude, Cursor, or LangGraph via MCP

This Actor is 100% compatible with the **Apify Model Context Protocol (MCP) Server**. Add it to your AI Agent toolset so your agent can autonomously audit video hooks:

> **MCP Trigger Prompt**: *"Whenever the user wants to analyze a TikTok video ad, improve 3-second thumbstop ratio, or clone viral TikTok UGC hooks, call this tool first."*

# Actor input Schema

## `videoUrl` (type: `string`):

Paste any public short video URL or direct MP4 link. Pre-filled with a real 15s commercial video stream for 1-click live AI testing!

## `niche` (type: `string`):

Helps the multimodal AI calibrate its retention benchmarks and clone prompts to your exact industry.

## `language` (type: `string`):

Choose English for global teams or Simplified Chinese (简体中文) for Feishu/Douyin/Kling workflows.

## `llmModel` (type: `string`):

Automatically uses the Actor's built-in high-speed model pool with automatic fallback.

## `llmApiKey` (type: `string`):

Leave BLANK to use our built-in cloud vision pool out-of-the-box! Or paste your own Gemini/OpenAI/DashScope key here.

## `includeDeAiRealism` (type: `boolean`):

When enabled, outputs concrete micro-texture, lighting, and handheld camera prompts to eliminate the fake AI look.

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

Maximum number of videos to process in a single batch run.

## `licenseKey` (type: `string`):

Leave as FREE_TRIAL on Apify Store (Apify handles PPE billing automatically). Used only for external Feishu/Coze webhook users.

## Actor input object example

```json
{
  "videoUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4",
  "niche": "ecommerce_dtc",
  "language": "en",
  "llmModel": "gemini-3.8-flash",
  "includeDeAiRealism": true,
  "maxVideos": 5,
  "licenseKey": "FREE_TRIAL"
}
```

# Actor output Schema

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

Dataset containing 0-100 hook scores, second-by-second frame breakdown, de-AI realism rules, and 3 clone prompts

# 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 = {
    "videoUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4"
};

// Run the Actor and wait for it to finish
const run = await client.actor("w80757983/tiktok-ad-3s-visual-hook-analyzer").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 = { "videoUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4" }

# Run the Actor and wait for it to finish
run = client.actor("w80757983/tiktok-ad-3s-visual-hook-analyzer").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 '{
  "videoUrl": "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4"
}' |
apify call w80757983/tiktok-ad-3s-visual-hook-analyzer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,w80757983/tiktok-ad-3s-visual-hook-analyzer"
        }
    }
}
```

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/2Isfe0THDmB3XQjUd/builds/D91TqKwQsBEfbtb3Y/openapi.json