# AI Video Viral Radar (`replay/ai-video-viral-radar`) Actor

Find viral AI-generated videos (Higgsfield, Kling, Seedance, Veo, Dreamina, Grok Imagine…) on YouTube & TikTok, with AI-tool detection, cross-platform viral score and AI tool trends.

- **URL**: https://apify.com/replay/ai-video-viral-radar.md
- **Developed by:** [A D](https://apify.com/replay) (community)
- **Categories:** Social media, AI, Videos
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 video 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

## AI Video Viral Radar

**Find the AI-generated videos that are going viral right now, and see which AI video generator is behind them.**
Scans YouTube (videos + Shorts) and TikTok, keeps only videos that are *actually AI-generated* (not videos *about* AI), detects the tool used (**Higgsfield, Kling, Seedance, Veo, Dreamina, Grok Imagine**, Hailuo/MiniMax, Runway, Pika, Luma, OpenArt, Krea, Wan, Vidu, PixVerse, Midjourney…) and ranks everything with a cross-platform **viral score**.

### Why this actor?

- **AI-generated filter**: combines the platforms' own AI labels (YouTube "altered or synthetic content", TikTok AIGC), disclosures, hashtags and tool names, with anti-false-positive rules (a "runway" fashion show or "Pikachu" is not an AI tool).
- **AI tool detection**: 25+ generators recognized.
- **Viral score (0–100)**: views per hour, engagement and outlier ratio (views / followers), normalized per platform so YouTube and TikTok are comparable.
- **AI tool trends report**: which generator is rising this week (videos, views, median views/hour, share of last 7 days).
- Built-in residential proxy support (Apify Proxy), no login, no cookies.

### Use cases

Creators looking for viral AI formats, AI video agencies & brands doing trend watching, AI tool marketers tracking competitors, journalists and researchers.

### Input

Defaults work out of the box. Main options: platforms, YouTube queries, TikTok accounts to watch, max age, min views, min AI confidence, max videos returned. See the Input tab.

### Output example (real data, October 2026)

```json
{
  "rank": 4, "viralScore": 85.5, "platform": "YouTube",
  "url": "https://www.youtube.com/watch?v=SkorusaTwbw",
  "title": "Beautiful Diver Tries to Climb Out of a Hidden Cenote… Then Something Rises in Front of Her",
  "author": "ButacaSalvaje2", "authorFollowers": 556000,
  "views": 32712675, "likes": 137447, "comments": 1900,
  "publishedAt": "2026-09-22T21:31:02+00:00", "viewsPerHour": 65740.9,
  "contentType": "generated", "aiConfidence": 1.0, "platformAiLabel": true,
  "aiToolsDetected": ["Dreamina"]
}
```

```json
{
  "rank": 6, "viralScore": 84.7, "platform": "TikTok",
  "url": "https://www.tiktok.com/@liliscozylife/video/7695812888639835412",
  "title": "😍😍 #ai #viral #explore #lili #veo3", "views": 829100, "likes": 24800, "shares": 6912,
  "publishedAt": "2026-10-12T16:04:34+00:00", "viewsPerHour": 36047.8,
  "contentType": "generated", "aiConfidence": 0.75, "aiToolsDetected": ["Veo"]
}
```

Key-value store: `TOOL_TRENDS` (AI tool trends), `RUN_STATS`, `RAW_ITEMS`.

### Pricing (pay per event)

- **$0.004 per video returned** ($4 per 1,000 videos)
- **$0.02 per AI tool trends report** (optional, once per run)
  Proxy traffic is included. Set *Max videos returned* to cap your cost.

### FAQ

**Is it legal?** The actor only collects publicly available metadata (titles, counts, dates, public profiles). It does not log in, does not download videos and collects no private data. You are responsible for your use of the data (GDPR, platform terms of service). Contact us for removal requests.

**How accurate is the AI detection?** On our labeled test sets (Oct 2026): precision 1.0 and recall 0.88–1.0. Videos without any label, disclosure or tool mention can be missed; aiConfidence and aiReasons explain each decision.

**Why are some AI tools "not detected"?** Many creators don't name the tool. Tool detection only relies on explicit signals.

**Limits**: YouTube and TikTok may rate-limit; the actor uses residential proxies and returns what it could collect. Instagram and X are not enabled by default (X requires your own API token). Counts are snapshots at collection time.

### Keywords

AI video, viral AI videos, AI generated video finder, AI video trends, Higgsfield, Kling AI, Seedance, Veo 3, Dreamina, Grok Imagine, Hailuo, Runway, TikTok trends, YouTube Shorts trends, viral score, AI content detection.

# Actor input Schema

## `platforms` (type: `array`):

Platforms to scan: youtube, tiktok (free sources). 'x' needs your own X_BEARER_TOKEN env var.

## `queries` (type: `array`):

Keyword searches run on YouTube.

## `perQuery` (type: `integer`):

Videos fetched per YouTube query (before AI filtering; roughly half are kept). Leave empty: 8, scaled up with Max videos returned.

## `tiktokAccounts` (type: `array`):

Usernames (without @) of AI video creators to scan. Leave empty for the built-in list.

## `perAccount` (type: `integer`):

Videos per TikTok account. Leave empty: 8, scaled up with Max videos returned.

## `window` (type: `string`):

YouTube upload window.

## `maxAgeDays` (type: `integer`):

Max video age (days).

## `minViews` (type: `integer`):

Min views.

## `minAiConfidence` (type: `string`):

Threshold for 'AI-generated' classification.

## `includeTutorials` (type: `boolean`):

Include AI tutorials.

## `maxItems` (type: `integer`):

Each returned video is a billable event.

## `toolTrendsReport` (type: `boolean`):

Saves TOOL_TRENDS (which AI generator is rising) in the key-value store. Billed once per run.

## `useApifyProxy` (type: `boolean`):

Fallback only: requests go direct first and switch to Apify Proxy only when a platform blocks them.

## `apifyProxyGroups` (type: `array`):

Apify proxy groups.

## `proxyUrl` (type: `string`):

Optional http://user:pass@host:port, used only as a last resort after direct and Apify Proxy.

## `labelCheckTop` (type: `integer`):

Check platform AI labels on top N.

## `maxCollectSecs` (type: `integer`):

Time budget for collection (default 180 s, also capped at ~50% of the run timeout); results and report are always saved before the run ends.

## `youtubeConcurrency` (type: `integer`):

Parallel YouTube metadata requests.

## Actor input object example

```json
{
  "platforms": [
    "youtube"
  ],
  "queries": [
    "Veo 3 AI video",
    "Kling AI video",
    "Higgsfield AI video"
  ],
  "window": "month",
  "maxAgeDays": 30,
  "minViews": 10000,
  "minAiConfidence": "0.3",
  "includeTutorials": false,
  "maxItems": 10,
  "toolTrendsReport": true,
  "useApifyProxy": true,
  "apifyProxyGroups": [
    "RESIDENTIAL"
  ],
  "labelCheckTop": 10,
  "maxCollectSecs": 180,
  "youtubeConcurrency": 6
}
```

# Actor output Schema

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

Viral AI-generated videos found on YouTube and TikTok, with AI-tool detection, viral score and AI tool trends.

# 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 = {
    "platforms": [
        "youtube"
    ],
    "queries": [
        "Veo 3 AI video",
        "Kling AI video",
        "Higgsfield AI video"
    ],
    "maxItems": 10,
    "labelCheckTop": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("replay/ai-video-viral-radar").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 = {
    "platforms": ["youtube"],
    "queries": [
        "Veo 3 AI video",
        "Kling AI video",
        "Higgsfield AI video",
    ],
    "maxItems": 10,
    "labelCheckTop": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("replay/ai-video-viral-radar").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 '{
  "platforms": [
    "youtube"
  ],
  "queries": [
    "Veo 3 AI video",
    "Kling AI video",
    "Higgsfield AI video"
  ],
  "maxItems": 10,
  "labelCheckTop": 10
}' |
apify call replay/ai-video-viral-radar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,replay/ai-video-viral-radar"
        }
    }
}
```

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/jbnG43WOO3bIMa7G9/builds/UWDch7LVfCLW8fEa0/openapi.json