Skip to main content

Overview

The YouTube block retrieves video data from YouTube. Use it to search for videos by keyword, get video details, or extract transcripts for content research, competitor analysis, and video content creation.

Configuration

Operation

Select the YouTube operation to perform.
OperationDescription
Search VideosSearch YouTube for videos by keyword
Get Video DetailsRetrieve detailed information about a specific video

Search Videos Configuration

Use these settings when the operation is set to “Search Videos”.

Search Query

Enter the keyword or phrase to search for on YouTube. This field supports placeholders for dynamic values. Examples:
  • Static search: SEO tutorial 2024
  • From previous step: {{step_1.output.topic}}
  • Combined: {{input.keyword}} tutorial

Max Results

Set the maximum number of videos to retrieve.
  • Default: 10 videos
  • Recommended: Start with 10, increase as needed

Sorting Order

Choose how search results are sorted.
Sort OptionDescription
RelevanceMost relevant to your search term (default)
DateMost recently uploaded
ViewsMost viewed videos
RatingHighest rated videos

Search Videos Output

The Search Videos operation returns an array of video objects.

Output Structure

[
  {
    "title": "Complete SEO Tutorial for Beginners",
    "url": "https://www.youtube.com/watch?v=abc123",
    "thumbnailUrl": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg",
    "viewCount": 1250000,
    "date": "2024-01-15",
    "likes": 45000,
    "channelName": "SEO Expert",
    "channelUrl": "https://www.youtube.com/channel/...",
    "channelUsername": "@seoexpert",
    "duration": "25:30",
    "commentsCount": 1200,
    "text": "In this tutorial, I'll show you everything you need to know about SEO...",
    "hashtags": ["#SEO", "#Tutorial", "#Marketing"]
  }
]

Search Videos Output Fields

FieldDescription
titleVideo title
urlDirect URL to the video
thumbnailUrlVideo thumbnail image URL
viewCountNumber of views
dateUpload date
likesNumber of likes
channelNameName of the YouTube channel
channelUrlURL to the channel
channelUsernameChannel username/handle
durationVideo length (e.g., “25:30”)
commentsCountNumber of comments
textVideo description
hashtagsArray of hashtags used

Accessing Search Results

Get first video:
{{step_n.output[0]}}
Get first video title:
{{step_n.output[0].title}}
Get first video URL (to use with Get Video Details):
{{step_n.output[0].url}}
Loop through all videos:
{% for video in step_n.output %}
  Title: {{ video.title }}
  Views: {{ video.viewCount }}
  Channel: {{ video.channelName }}
{% endfor %}

Get Video Details Configuration

Use these settings when the operation is set to “Get Video Details”.

Video URL

Enter the full YouTube video URL. This field supports placeholders for dynamic values. Examples:
  • Direct URL: https://www.youtube.com/watch?v=abc123
  • From previous step: {{step_1.output[0].url}}
  • From loop: {{current.url}}

Get Transcript

Enable this option to download the video’s subtitles/transcript.
  • Enabled: Includes transcript in SRT format
  • Disabled: Returns video details without transcript (default)
Transcripts are useful for content repurposing, SEO analysis, and extracting key points from videos.

Get Video Details Output

The Get Video Details operation returns a single video object with detailed information.

Output Structure

{
  "title": "Complete SEO Tutorial for Beginners",
  "thumbnailUrl": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg",
  "viewCount": 1250000,
  "date": "2024-01-15",
  "likes": 45000,
  "channelName": "SEO Expert",
  "channelUrl": "https://www.youtube.com/channel/...",
  "numberOfSubscribers": 500000,
  "duration": "25:30",
  "commentsCount": 1200,
  "text": "In this tutorial, I'll show you everything you need to know about SEO...",
  "subtitles": "1\n00:00:00,000 --> 00:00:05,000\nWelcome to this SEO tutorial...\n\n2\n00:00:05,000 --> 00:00:10,000\nToday we'll cover..."
}

Get Video Details Output Fields

FieldDescription
titleVideo title
thumbnailUrlVideo thumbnail image URL
viewCountNumber of views
dateUpload date
likesNumber of likes
channelNameName of the YouTube channel
channelUrlURL to the channel
numberOfSubscribersChannel subscriber count
durationVideo length
commentsCountNumber of comments
textVideo description
subtitlesTranscript in SRT format (if requested)

Accessing Video Details

Get video title:
{{step_n.output.title}}
Get transcript:
{{step_n.output.subtitles}}
Get channel info:
Channel: {{step_n.output.channelName}} ({{step_n.output.numberOfSubscribers}} subscribers)

Credits

OperationCredits
Search Videos20 credits per 10 results
Get Video Details5 credits per video
Examples:
  • Search returning 10 videos = 20 credits
  • Search returning 15 videos = 40 credits
  • Get details for 1 video = 5 credits

Best Practices

Search Videos

  • Use specific keywords for more relevant results
  • Include year or “2024” for recent content
  • Start with 10 results, increase if needed
  • Use “Views” sort to find popular content
  • Use “Date” sort for trending topics

Get Video Details

  • Enable transcript for content repurposing
  • Combine with LLM to summarize long videos
  • Extract key timestamps from transcripts
  • Use subscriber count to assess channel authority

Common Use Cases

Use CaseOperationConfiguration Tips
Topic researchSearch VideosSearch your keyword, sort by Views
Competitor analysisSearch VideosSearch competitor brand name
Content repurposingGet Video DetailsEnable transcript, analyze with LLM
Trending contentSearch VideosSort by Date for recent uploads
Influencer researchSearch VideosAnalyze channel subscriber counts
Video script creationGet Video DetailsExtract transcript, rewrite with LLM

Example Workflow: Video Research

Research video content on a topic:
  1. YouTube Block (Search Videos):
    • Operation: Search Videos
    • Search Query: {{input.topic}} tutorial
    • Max Results: 10
    • Sorting Order: Views
  2. LLM Block:
    Analyze these top YouTube videos about "{{input.topic}}":
    
    1. What topics do the most popular videos cover?
    2. What are common video lengths?
    3. What patterns do you see in titles?
    4. What content gaps exist?
    
    Videos:
    {{step_1.output}}
    
  3. Google Sheets Block: Store research findings

Example Workflow: Transcript Analysis

Extract and analyze video transcripts:
  1. YouTube Block (Search Videos):
    • Operation: Search Videos
    • Search Query: {{input.keyword}}
    • Max Results: 5
    • Sorting Order: Views
  2. Loop Block: Process each video
  3. YouTube Block (Get Video Details):
    • Operation: Get Video Details
    • Video URL: {{current.url}}
    • Get Transcript: Enabled
  4. LLM Block:
    Summarize this video transcript:
    - Main topics covered
    - Key takeaways (5 bullet points)
    - Actionable tips mentioned
    
    Transcript:
    {{step_3.output.subtitles}}
    
  5. Google Sheets Block: Append summaries

Example Workflow: Competitor Video Analysis

Analyze competitor YouTube content:
  1. Google Sheets Block: Read list of competitor channel names
  2. Loop Block: Process each competitor
  3. YouTube Block (Search Videos):
    • Operation: Search Videos
    • Search Query: {{current.channel_name}}
    • Max Results: 10
    • Sorting Order: Views
  4. LLM Block:
    Analyze {{current.channel_name}}'s top YouTube videos:
    - Content themes
    - Average engagement (views, likes)
    - Video format patterns
    - Opportunities to differentiate
    
    {{step_3.output}}
    
  5. Google Sheets Block: Append competitor analysis

Troubleshooting

Search Videos Issues

IssueCauseSolution
No videos foundSearch term too specificTry broader keywords
Irrelevant resultsGeneric search termAdd more specific keywords
Old videos onlyDefault sortingUse “Date” sort for recent content

Get Video Details Issues

IssueCauseSolution
Video not foundInvalid URLVerify the YouTube URL is correct
No transcriptSubtitles unavailableNot all videos have transcripts
Empty transcriptAuto-captions disabledVideo owner hasn’t enabled captions
Slow responseTranscript processingTranscripts take longer to fetch

What’s Next

Now that you understand the YouTube block: