# ViralGap Finder AI Pro (`sanchaychakma/viralgap-finder-ai-pro`) Actor

Discover YouTube content opportunities with data-driven insights. Analyze video performance, identify promising niches, explore competition, and generate content ideas for Shorts and long-form videos.

- **URL**: https://apify.com/sanchaychakma/viralgap-finder-ai-pro.md
- **Developed by:** [Sanchay Chakma](https://apify.com/sanchaychakma) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

## ViralGap Finder AI Pro 🚀

**Discover trending topics, research audience interest, and generate YouTube video ideas using Google Trends data.**

ViralGap Finder AI Pro helps content creators, YouTubers, marketers, and researchers discover trending search topics across multiple countries and turn them into actionable video content ideas.

Whether you create YouTube Shorts or long-form videos, this Actor helps you find topics worth exploring.

### ✨ Key Features

#### 🌍 Multi-Country Trend Research

Discover trending topics using Google Trends RSS feeds from supported countries.

Supported regions include:

- United States (US)
- Bangladesh (BD)
- India (IN)
- United Kingdom (GB)
- Canada (CA)
- Australia (AU)

You can also select multiple countries using supported country codes.

#### 🔥 Trending Topic Discovery

Collect current topics from Google Trends RSS feeds.

Results may include:

- Trending topic
- Countries where the topic was found
- Google Trends RSS search traffic estimate
- Keyword relevance score, when keywords are provided

**Note:** Google Trends search traffic is not the same as YouTube search volume.

#### 🎬 YouTube Video Idea Generator

Automatically generate suggested video titles and opening hooks based on trending topics.

Each topic can produce multiple content ideas.

Use these ideas as starting points for:

- YouTube Shorts
- Long-form YouTube videos
- Educational videos
- News explainers
- Trending-topic research

Generated ideas are templates and should be reviewed for accuracy and originality before publishing.

#### 🔎 YouTube Search Links

Each result includes a YouTube search link to help you manually explore videos related to the trending topic.

#### ⚡ Basic Mode — No API Key Required

Basic Mode uses Google Trends RSS data and generates content ideas.

It does not require a YouTube API key.

Basic Mode includes:

- Google Trends topic discovery
- Multi-country research
- Keyword matching
- Suggested video titles
- Video hooks
- YouTube search links

#### 📊 Advanced Mode — Optional YouTube Research

Advanced Mode requires your own valid YouTube Data API v3 key.

When the API is available, the Actor attempts to retrieve public YouTube video statistics for related videos.

Advanced research may include:

- Sampled YouTube video counts
- Public view and like statistics
- Estimated competition score
- Estimated opportunity score

**Important:** Competition and opportunity scores are experimental heuristics based on sampled videos. They are not official YouTube metrics, comprehensive market competition measurements, or guarantees of future performance.

If YouTube API research fails, these scores may be unavailable.

### 🚀 How to Use

1. Open ViralGap Finder AI Pro.
2. Choose **Basic** or **Advanced** research mode.
3. Optionally enter keywords.
4. Select your target region.
5. Choose topic selection settings.
6. Set the maximum number of topics.
7. Choose the number of video ideas per topic.
8. Select your content type.
9. If using Advanced Mode, provide your own YouTube Data API v3 key.
10. Click **Start**.

After the run finishes, open the dataset to view or export your research results.

### ⚙️ Input Options

| Input | Description |
|---|---|
| Research Mode | Basic Google Trends research or optional Advanced YouTube research |
| Keywords | Optional keywords for filtering or ranking topics |
| Region | Target country or supported multi-country selection |
| Custom Country Codes | Comma-separated country codes |
| Topic Selection | Select available trends, keyword-related topics, or both |
| Maximum Results | Maximum number of topics to process |
| Ideas Per Topic | Number of suggested video ideas per topic |
| Content Type | Shorts or long-form video ideas |
| YouTube API Key | Required for Advanced Mode |
| YouTube Videos Per Topic | Number of YouTube videos to request per topic |

### 📦 Output Data

Each dataset row represents one suggested video idea associated with a trending topic.

Example:

```json
{
  "trend": "example trending topic",
  "countries": "US, IN",
  "estimatedSearchTraffic": "2000+",
  "relevanceScore": null,
  "opportunityScore": null,
  "competitionScore": null,
  "youtubeVideosAnalyzed": 0,
  "suggestedVideoTitle": "Example Trending Topic: Explained in 60 Seconds",
  "videoHook": "Here are the key facts about this trending topic.",
  "youtubeSearchUrl": "https://www.youtube.com/results?search_query=example",
  "dataStatus": "Google trend verified; YouTube analysis not requested"
}
```

*This example is illustrative, not a live result.*

#### Understanding the Results

**Trending Topic:** A topic retrieved from Google Trends RSS.

**Countries:** Countries in which the Actor found the topic.

**Google RSS Traffic:** Search traffic estimate reported by Google Trends RSS.

**Keyword Match %:** A keyword relevance indicator, when applicable.

**Video Title Idea:** Automatically generated title suggestion.

**Video Hook:** Suggested opening line.

**YouTube Search:** Link for manual YouTube research.

**YouTube Videos Analyzed:** Number of videos successfully included in optional YouTube research.

**Opportunity Score:** Experimental heuristic available only when sufficient Advanced Mode data is retrieved.

**Competition Score:** Experimental heuristic available only when sufficient Advanced Mode data is retrieved.

**Data Source / Status:** Information about the research performed.

### 💡 Who Is This For?

ViralGap Finder AI Pro is designed for:

- YouTube content creators
- YouTube Shorts creators
- Social media marketers
- Content research teams
- Digital agencies
- Trend researchers
- Video content planners

### ⚠️ Important Limitations

- Trending topics are sourced from Google Trends RSS, not YouTube's internal trending rankings.
- Google search traffic does not represent YouTube views or YouTube search volume.
- Trending topic availability depends on Google's published RSS feeds.
- Generated video ideas may require fact-checking and editing.
- The Actor does not predict whether a video will go viral.
- Basic Mode does not calculate YouTube competition or opportunity scores.
- Advanced Mode requires a working YouTube Data API v3 key and available API quota.
- Advanced scores are approximate heuristics, not verified market measurements.
- Results can change as trending topics change.
- The number of dataset rows may exceed the number of unique topics because each topic can produce multiple video ideas.

### 📤 Export Options

Results are stored in an Apify dataset and can be accessed through supported dataset export formats and Apify integrations.

### 🔐 API Key Privacy

Advanced Mode users must provide their own YouTube Data API v3 key.

Keep your API key private and use the designated secret input field.

### 🎯 Start Researching

Discover current Google search trends, explore potential content topics, and generate your next batch of YouTube video ideas with ViralGap Finder AI Pro.

# Actor input Schema

## `mode` (type: `string`):

Choose Basic for trends and video ideas, or Advanced to include YouTube research using your own API key.

## `keywords` (type: `string`):

Enter multiple keywords separated by commas or new lines. Leave empty to research all available trends.

## `region` (type: `string`):

Choose a country, selected worldwide countries, or enter custom country codes.

## `customCountries` (type: `string`):

Used only when Region is Custom Countries. Enter ISO two-letter country codes separated by commas, for example US,JP,DE.

## `searchMode` (type: `string`):

Show all available trends, only matching keywords, or prioritize keyword matches.

## `maxResults` (type: `integer`):

Maximum number of unique trending topics to research. Actual results depend on available trend data.

## `ideasPerTopic` (type: `integer`):

Number of video ideas to generate for each researched topic.

## `contentType` (type: `string`):

Choose whether to generate content ideas for YouTube Shorts or long-form YouTube videos.

## `youtubeApiKey` (type: `string`):

Your own YouTube Data API key. Required only for Advanced research mode. Keep this key private.

## `youtubeVideosPerTopic` (type: `integer`):

Maximum number of YouTube videos to compare for each topic in Advanced mode.

## Actor input object example

```json
{
  "mode": "basic",
  "keywords": "",
  "region": "worldwide",
  "customCountries": "US,IN,GB",
  "searchMode": "both",
  "maxResults": 20,
  "ideasPerTopic": 3,
  "contentType": "shorts",
  "youtubeVideosPerTopic": 5
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("sanchaychakma/viralgap-finder-ai-pro").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("sanchaychakma/viralgap-finder-ai-pro").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 '{}' |
apify call sanchaychakma/viralgap-finder-ai-pro --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sanchaychakma/viralgap-finder-ai-pro"
        }
    }
}
```

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/zWO1fqzdE9O4ZhPTP/builds/TwT2O5daBedf4uBYo/openapi.json