Video Intelligence

Complete video analysis in one API call: extract metadata, generate transcripts, create SEO content, build chapter markers, produce summaries, and analyze content type. Works with Vimeo, Dailymotion, TED, Twitch, Rumble, and 1000+ other platforms.

No API keys needed - all AI processing (transcription + content generation) is included in the actor pricing.

Why Video Intelligence?

• All-in-One Solution - Metadata, transcript, SEO, chapters, summaries, and analysis in a single request
• 1000+ Platform Support - Works with Vimeo, Dailymotion, TED, Twitch, Rumble, Bitchute, Odysee, and virtually any video hosting platform
• No API Keys Required - Groq Whisper transcription and Gemini AI analysis included. No external accounts needed
• Accurate Timestamps - Get precise start/end times for every segment, perfect for subtitles and navigation
• SEO-Ready Output - Optimized titles, descriptions, keywords, and hashtags ready for publishing
• YouTube Chapters - Copy-paste chapter timestamps directly into video descriptions
• 50+ Languages - Automatic language detection for transcription, output in 30+ languages
• Residential Proxies - Built-in proxy support for reliable access to protected platforms

Quick Start

Via Apify Console

{
    "url": "https://player.vimeo.com/video/347119375"
}

That's it. All features are enabled by default.

Via Apify API (cURL)

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~video-intelligence/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://player.vimeo.com/video/347119375"}'

Via Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('YOUR_USERNAME/video-intelligence').call({
    url: 'https://player.vimeo.com/video/347119375',
    language: 'en',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
const result = items[0];

console.log(result.metadata.title);       // Video title
console.log(result.transcript.text);      // Full transcript
console.log(result.seo.title);            // SEO-optimized title
console.log(result.youtubeTimestamps);    // Ready-to-paste chapters
console.log(result.summary.keyPoints);    // Key takeaways
console.log(result.analysis.contentType); // Content classification

Via Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_TOKEN')

run = client.actor('YOUR_USERNAME/video-intelligence').call(run_input={
    'url': 'https://player.vimeo.com/video/347119375',
    'language': 'en',
})

items = client.dataset(run['defaultDatasetId']).list_items().items
result = items[0]

print(result['metadata']['title'])       # Video title
print(result['transcript']['text'])      # Full transcript
print(result['seo']['title'])            # SEO-optimized title
print(result['youtubeTimestamps'])       # Ready-to-paste chapters
print(result['summary']['keyPoints'])    # Key takeaways
print(result['analysis']['contentType']) # Content classification

How It Works

1. Submit a URL - Paste any video URL from a supported platform
2. Download - The actor downloads the video using yt-dlp with residential proxy support
3. Extract Audio - Audio is extracted and optimized for transcription
4. Transcribe - Groq Whisper AI processes the audio with state-of-the-art accuracy
5. Analyze - Gemini AI generates SEO content, chapters, summaries, and content analysis
6. Return Results - You receive complete intelligence data in structured JSON format

Supported Platforms

This actor supports video analysis from 1000+ platforms via yt-dlp. Here are some popular ones:

Platform	Status	Notes
Vimeo	Supported	Use player.vimeo.com URL format for best results
Dailymotion	Supported	Full support
Twitch	Supported	VODs and clips
TED Talks	Supported	Lectures and presentations
Rumble	Supported	Full support
Bitchute	Supported	Full support
Odysee	Supported	Full support
SoundCloud	Supported	Audio-only transcription
PeerTube	Supported	Any instance
Bilibili	Supported	Chinese platform
Niconico	Supported	Japanese platform
VK Video	Supported	Russian platform
Archive.org	Supported	Internet Archive videos
Viki	Supported	Asian content platform

Plus hundreds more via yt-dlp supported sites.

Platforms Requiring Authentication

Some platforms require authentication cookies to access content:

Scenario	Solution
Private videos	Export cookies from your browser and provide in cookies field
Age-restricted content	Export cookies from a logged-in browser session
Geo-restricted content	Try different proxy countries in settings

Input Parameters

Parameter	Type	Required	Default	Description
url	string	Yes	-	Video URL from any supported platform
language	string	No	"en"	Output language for AI-generated content
includeTranscript	boolean	No	true	Include full transcript with timestamps
includeSeo	boolean	No	true	Generate SEO-optimized content
includeChapters	boolean	No	true	Generate chapter markers
includeSummary	boolean	No	true	Generate multi-length summaries
includeAnalysis	boolean	No	true	Analyze content type, tone, audience
useResidentialProxy	boolean	No	true	Use residential proxies for reliability
proxyCountry	string	No	"US"	Proxy location (US, GB, DE, etc.)
cookies	string	No	-	Netscape-format cookies for private videos

Supported Output Languages

The actor supports 30+ languages for AI-generated content (SEO, summaries, chapters):

Code	Language	Code	Language	Code	Language
en	English	ja	Japanese	ar	Arabic
es	Spanish	zh	Chinese	ru	Russian
fr	French	ko	Korean	hi	Hindi
de	German	pt	Portuguese	nl	Dutch
it	Italian	pl	Polish	tr	Turkish

Output Format

Complete JSON Output

{
    "url": "https://player.vimeo.com/video/347119375",
    "platform": "vimeo",
    "metadata": {
        "id": "347119375",
        "title": "Example Video Title",
        "description": "Original video description...",
        "duration": 180,
        "durationFormatted": "3:00",
        "uploader": "Channel Name",
        "uploadDate": "20240115",
        "viewCount": 15000,
        "thumbnail": "https://i.vimeocdn.com/video/..."
    },
    "transcript": {
        "language": "English",
        "text": "Full transcript text appears here...",
        "segments": [
            { "text": "First segment of speech.", "start": 0, "end": 4.5 },
            { "text": "Second segment continues here.", "start": 4.5, "end": 9.2 }
        ]
    },
    "seo": {
        "title": "SEO-Optimized Video Title (60 chars max)",
        "description": "Compelling meta description optimized for search engines (160 chars max)...",
        "keywords": ["keyword1", "keyword2", "keyword3"],
        "hashtags": ["#Topic1", "#Topic2", "#Topic3"],
        "tags": ["tag1", "tag2", "tag3", "tag4", "tag5"]
    },
    "chapters": [
        {
            "title": "Introduction",
            "startTime": 0,
            "endTime": 30,
            "summary": "Brief overview of the chapter content",
            "topics": ["topic1", "topic2"]
        },
        {
            "title": "Main Content",
            "startTime": 30,
            "endTime": 150,
            "summary": "Detailed explanation of the main topic",
            "topics": ["topic3", "topic4"]
        }
    ],
    "youtubeTimestamps": "00:00 - Introduction\n00:30 - Main Content\n02:30 - Conclusion",
    "summary": {
        "hook": "One-line attention grabber for social media",
        "brief": "2-3 sentence overview of the video content.",
        "detailed": "Full paragraph summary covering all main points discussed in the video...",
        "keyPoints": [
            "First key takeaway",
            "Second key takeaway",
            "Third key takeaway"
        ],
        "topics": ["Primary Topic", "Secondary Topic"]
    },
    "analysis": {
        "contentType": "tutorial",
        "tone": "educational",
        "targetAudience": "developers learning web development",
        "complexity": "intermediate"
    },
    "processedAt": "2025-01-11T12:00:00.000Z"
}

Output Fields Reference

Metadata

Field	Type	Description
metadata.id	string	Platform-specific video ID
metadata.title	string	Original video title
metadata.description	string	Original video description
metadata.duration	number	Duration in seconds
metadata.durationFormatted	string	Human-readable duration (e.g., "3:45")
metadata.uploader	string	Channel or uploader name
metadata.uploadDate	string	Upload date (YYYYMMDD format)
metadata.viewCount	number	View count (if available)
metadata.thumbnail	string	Thumbnail URL

Transcript

Field	Type	Description
transcript.language	string	Detected language name
transcript.text	string	Complete transcript as single string
transcript.segments	array	Array of timestamped segments
transcript.segments[].text	string	Segment text content
transcript.segments[].start	number	Start time in seconds
transcript.segments[].end	number	End time in seconds

SEO Content

Field	Type	Description
seo.title	string	SEO-optimized title (max 60 chars)
seo.description	string	Meta description (max 160 chars)
seo.keywords	array	Relevant keywords for search
seo.hashtags	array	Social media hashtags
seo.tags	array	Platform tags for discoverability

Chapters

Field	Type	Description
chapters[].title	string	Chapter title
chapters[].startTime	number	Start time in seconds
chapters[].endTime	number	End time in seconds
chapters[].summary	string	Brief chapter summary
chapters[].topics	array	Topics covered in chapter
youtubeTimestamps	string	Ready-to-paste YouTube chapter format

Summary

Field	Type	Description
summary.hook	string	One-line attention grabber
summary.brief	string	2-3 sentence overview
summary.detailed	string	Full paragraph summary
summary.keyPoints	array	5-7 main takeaways
summary.topics	array	Primary themes discussed

Analysis

Field	Type	Description
analysis.contentType	string	Type: tutorial, vlog, interview, lecture, review, etc.
analysis.tone	string	Tone: educational, entertaining, casual, professional
analysis.targetAudience	string	Who benefits from this video
analysis.complexity	string	Level: beginner, intermediate, advanced

Pricing

Pay Per Event pricing based on video duration:

Video Length	Price per Video
Under 5 minutes	$0.15
5-15 minutes	$0.25
15-30 minutes	$0.35
30-60 minutes	$0.50
60-120 minutes	$0.75

Includes platform fees, transcription, and AI analysis. No additional API keys or costs required.

Cost Examples

Use Case	Videos	Estimated Cost
Analyze 10 short tutorials (3 min each)	10	$1.50
Process weekly podcast episodes (45 min)	4	$2.00
Analyze competitor videos (mixed lengths)	20	$5.00-7.00

Use Cases

Content Repurposing

Convert tutorials, podcasts, and webinars into blog posts, articles, and social media content. Extract key quotes and generate multiple content formats from a single video.

Video SEO Optimization

Generate optimized titles, descriptions, and tags to improve video discoverability. Create compelling meta content that ranks in search results.

Chapter Generation

Automatically create chapter markers for long-form content. Copy-paste YouTube timestamps directly into video descriptions for better viewer navigation.

Content Intelligence Platforms

Build video understanding capabilities into your applications. Extract structured data for search, recommendation, and analysis systems.

Research and Analysis

Transcribe interviews, lectures, and presentations for qualitative research. Make video archives fully searchable and analyzable.

E-Learning Platforms

Create searchable transcripts for educational videos. Enable students to search within video content and jump to specific topics.

Podcast Show Notes

Generate complete transcripts for podcast episodes. Create timestamped chapter markers and highlight key moments for show notes.

Media Monitoring

Monitor and analyze video content for brand mentions, competitor analysis, or news tracking across multiple platforms.

Limitations

• Maximum video length: 2 hours (Apify timeout limit)
• Live streams: Not supported (recorded content only)
• DRM-protected content: Cannot be downloaded or analyzed
• Some platforms may require cookies: Private or age-restricted content needs authentication

Platform Notes

Vimeo

Use the player URL format for best results:

https://player.vimeo.com/video/347119375

The standard Vimeo URL format also works:

https://vimeo.com/347119375

Private Videos

For private or age-restricted videos:

1. Log into the platform in your browser
2. Use a cookie exporter extension to export cookies in Netscape format
3. Paste the cookies in the cookies input field

Geo-Restricted Content

If a video is geo-restricted:

1. Enable residential proxy (on by default)
2. Try different proxy countries in the proxyCountry setting
3. Choose a country where the video is available

FAQ

Do I need my own API keys?

No. Transcription (Groq Whisper) and AI analysis (Gemini) costs are included in the actor pricing. No external accounts or API keys required.

What languages are supported for transcription?

Over 50 languages are supported with automatic detection. The AI accurately identifies the spoken language and transcribes accordingly.

What languages are supported for AI-generated content?

You can generate SEO content, summaries, and chapters in 30+ languages including English, Spanish, French, German, Japanese, Chinese, and more.

How accurate is the transcription?

Groq Whisper AI provides industry-leading accuracy, typically 95%+ for clear audio. Results may vary based on audio quality, background noise, and accents.

Can I analyze private videos?

Yes, by providing authentication cookies exported from your browser in Netscape format. Use a browser extension like "Get cookies.txt" to export cookies.

What if a platform is blocked?

Enable residential proxies (on by default) and try different proxy countries. The actor uses yt-dlp which supports 1000+ platforms.

How long does analysis take?

Most videos process in 1-3 minutes. Longer videos may take proportionally longer depending on duration and AI analysis complexity.

Can I disable certain features?

Yes, you can disable any feature (transcript, SEO, chapters, summary, analysis) to reduce processing time and focus on specific outputs.

Can I process multiple videos?

The actor processes one video per run. For batch processing, use the Apify API to start multiple runs in parallel or integrate with a scheduler.

What output formats are available?

The actor returns structured JSON with all intelligence data. You can extract specific fields (transcript text, chapters, etc.) for your use case.

Technical Details

• AI Transcription: Groq Whisper (state-of-the-art speech recognition)
• AI Analysis: Gemini 2.0 Flash (fast, accurate content generation)
• Video Extraction: yt-dlp (supports 1000+ platforms)
• Proxy Support: Residential proxies with 20+ country options
• Audio Processing: Automatic extraction and optimization
• Runtime: Node.js 20 with TypeScript
• Memory: 2-8 GB (auto-scaled based on video length)

Integration Examples

Webhook Integration

// Start actor with webhook notification
const run = await client.actor('YOUR_USERNAME/video-intelligence').start({
    url: 'https://player.vimeo.com/video/347119375',
}, {
    webhooks: [{
        eventTypes: ['ACTOR.RUN.SUCCEEDED'],
        requestUrl: 'https://your-server.com/webhook',
    }],
});

Batch Processing

// Process multiple videos in parallel
const urls = [
    'https://vimeo.com/video1',
    'https://vimeo.com/video2',
    'https://vimeo.com/video3',
];

const runs = await Promise.all(
    urls.map(url =>
        client.actor('YOUR_USERNAME/video-intelligence').call({ url })
    )
);

Selective Features

{
    "url": "https://player.vimeo.com/video/347119375",
    "includeTranscript": true,
    "includeSeo": true,
    "includeChapters": false,
    "includeSummary": false,
    "includeAnalysis": false
}

---

Built by Ekipnico | Powered by Groq Whisper AI and Gemini AI