YouTube Captions and Descriptions Tutorial

Step 1: Prerequisites

Before you start, make sure you have the following prerequisites:

Python installed on your computer.
Pip installed for managing Python packages.
A YouTube Data API key. You can obtain one by following these instructions.
A text file containing YouTube video links (one link per line) that you want to process. Name this file links.txt.

Step 2: Install Required Libraries

You’ll need to install the necessary Python libraries. Open your terminal or command prompt and run the following commands:

pip install youtube-transcript-api

pip install google-api-python-client

Step 3: Create the Python Script

Create a Python script (e.g., download_captions_and_descriptions.py) and paste the following code into it:


from googleapiclient.discovery import build
from youtube_transcript_api import YouTubeTranscriptApi, NoTranscriptFound
import re
import os
import string

def get_video_info(video_id, youtube_api):
    request = youtube_api.videos().list(part="snippet", id=video_id)
    response = request.execute()

    if "items" in response and response["items"]:
        video_info = response["items"][0]["snippet"]
        return {
            "title": video_info["title"],
            "description": video_info["description"]
        }
    return None

def sanitize_filename(filename):
    valid_chars = "-_.() %s%s" % (string.ascii_letters, string.digits)
    return ''.join(c for c in filename if c in valid_chars)

def download_captions_and_description(input_filename, output_folder, language_code, api_key):
    youtube_api = build('youtube', 'v3', developerKey=api_key)

    if not os.path.exists(output_folder):
        os.makedirs(output_folder)

    with open(input_filename, 'r') as file:
        for line in file:
            video_url = line.strip()
            video_id = extract_video_id(video_url)

            if video_id:
                try:
                    video_info = get_video_info(video_id, youtube_api)
                    if video_info:
                        title = video_info["title"]
                        description = video_info["description"]
                        
                        transcript = YouTubeTranscriptApi.get_transcript(video_id, languages=[language_code])
                        if transcript:
                            transcript_text = '\n'.join([t['text'] for t in transcript])
                            filename = sanitize_filename(title) + ".txt"
                            save_transcript_and_description(filename, transcript_text, description, output_folder)
                        else:
                            print(f"No transcript found for video ID: {video_id}. Skipping to next video.")
                    else:
                        print(f"Video info not found for video ID: {video_id}. Skipping to next video.")
                except NoTranscriptFound:
                    print(f"No transcript found for video ID: {video_id}. Skipping to next video.")
                except Exception as e:
                    print(f"An error occurred while processing video ID: {video_id}. Error: {e}")
            else:
                print(f"Invalid URL: {video_url}. Skipping to next video.")

def extract_video_id(video_url):
    match = re.search(r'v=([0-9A-Za-z_-]{11})', video_url)
    return match.group(1) if match else None

def save_transcript_and_description(filename, transcript_text, description, output_folder):
    with open(os.path.join(output_folder, filename), 'w', encoding='utf-8') as file:
        file.write("Captions:\n")
        file.write(transcript_text)
        file.write("\n\nDescription:\n")
        file.write(description)
    print(f"Transcript and description saved as {filename}")

# Usage
input_filename = 'links.txt'
output_folder = 'transcripts_with_description'
language_code = 'en'  # Change to the desired language code (e.g., 'en' for English)
api_key = 'YOUR_API_KEY'  # Replace with your YouTube Data API key

download_captions_and_description(input_filename, output_folder, language_code, api_key)

Step 4: Replace API Key and Configure

– Replace 'YOUR_API_KEY' with your YouTube Data API key.
– If you want to change the language of captions, replace 'en' with the desired language code (e.g., 'es' for Spanish).

Step 5: Run the Script

Open your terminal or command prompt and navigate to the directory where the script is located. Run the script using the following command:

python download_captions_and_descriptions.py

The script will process the YouTube video links in links.txt, download captions, and descriptions for each video, and save them in the transcripts_with_description folder.

Step 6: Retrieve the Result

You can find the combined captions and descriptions for each video in the transcripts_with_description folder.

That’s it! You’ve successfully created a script to download captions and descriptions from YouTube video links.

Home improvement

WT FAQ

See Full Bio

Python Parsing – YouTube Captions and Descriptions Tutorial