Youtube

The "YouTube Integration" step allows you to extract and process content from YouTube videos. This powerful tool helps you transform video content into usable text, enabling content repurposing, transcription services, and enhanced video analysis.

How to Configure the YouTube Integration Step

Configuring the step requires setting the parameters shown below:

[IMAGE: Screenshot of the YouTube Integration step configuration panel]

Action Type

Select the specific YouTube action you want to perform:

• Extract Transcript: Retrieve the transcript from a YouTube video

Video URL or ID

Enter the YouTube video URL or ID from which you want to extract the transcript.

Examples:

• Full URL: https://www.youtube.com/watch?v=dQw4w9WgXcQ

• Short URL: https://youtu.be/dQw4w9WgXcQ

• Video ID: dQw4w9WgXcQ

You can use Liquid syntax to dynamically reference a YouTube URL from a previous step:

{{ step_1.output.youtube_url }}

Language (Optional)

Specify the language of the transcript you want to retrieve. If the video has transcripts in multiple languages, this parameter helps select the correct one.

• Default: Auto-detect (retrieves the default transcript for the video)

• Options include: English, Spanish, French, German, etc.

Output Format

The YouTube Integration step returns a JSON object containing the transcript data:

{
  "video_id": "dQw4w9WgXcQ",
  "video_title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
  "channel_name": "Rick Astley",
  "transcript": [
    {
      "text": "We're no strangers to love",
      "start": 0.0,
      "duration": 2.38
    },
    {
      "text": "You know the rules and so do I",
      "start": 2.38,
      "duration": 4.16
    },
    {
      "text": "A full commitment's what I'm thinking of",
      "start": 6.54,
      "duration": 3.42
    },
    {
      "text": "You wouldn't get this from any other guy",
      "start": 9.96,
      "duration": 4.28
    }
  ],
  "full_text": "We're no strangers to love\nYou know the rules and so do I\nA full commitment's what I'm thinking of\nYou wouldn't get this from any other guy\n...",
  "language": "en",
  "duration_seconds": 213
}

[IMAGE: Screenshot showing an example of the YouTube Integration results in the AirOps interface]

Understanding the Output

• video_id: The unique identifier of the YouTube video

• video_title: The title of the YouTube video

• channel_name: The name of the YouTube channel that published the video

• transcript: An array of transcript segments, each containing:

  • text: The transcribed text segment

  • start: The start time of the segment in seconds

  • duration: The duration of the segment in seconds

• full_text: The complete transcript as a single string with line breaks

• language: The language code of the transcript

• duration_seconds: The total duration of the video in seconds

How to Use the Results

You can access the transcript data in subsequent workflow steps using Liquid syntax. For example:

To access the complete transcript text:

{{ step_2.output.full_text }}

To access the video title:

{{ step_2.output.video_title }}

To loop through transcript segments in an LLM prompt:

{% for segment in step_2.output.transcript %}
[{{ segment.start | divided_by: 60 | floor }}:{{ segment.start | modulo: 60 | round }}] {{ segment.text }}
{% endfor %}

Common Use Cases

• Creating blog posts or articles from video content

• Generating show notes for podcasts or video episodes

• Analyzing video content for key topics and themes

• Creating timestamped summaries of long videos

• Building searchable video content libraries

• Translating video content into different languages

• Creating social media snippets from video transcripts

How to Continue if the Integration Fails

By default, the YouTube Integration step will terminate the workflow if it fails. To continue the workflow if the step fails, click "Continue" at the bottom of the settings panel.

[IMAGE: Screenshot showing the "Continue" option in the step settings]

The step will return the following keys when it fails:

• output: this will be null

• error:

  • message: the message returned from the step

  • code: the error code representing the error

Common error causes include:

• Invalid YouTube URL or video ID

• Video not found or removed

• No transcript available for the video

• Specified language not available

Example Workflow

Here's a common pattern using the YouTube Integration step:

1. Start with a YouTube video URL

2. Use the "YouTube Integration" step to extract the video transcript

3. Use an LLM step to analyze the transcript and:

   • Generate a concise summary of the video

   • Extract key points and takeaways

   • Create timestamped chapter markers

4. Use another LLM step to transform the content into a blog post or article

5. Use a CMS integration (like WordPress or Webflow) to publish the repurposed content

This workflow enables you to efficiently repurpose video content into written formats, extending the reach of your content and making it accessible in multiple formats while saving hours of manual transcription and writing time.