N8N Tools - YouTube Enhanced icon

N8N Tools - YouTube Enhanced

Comprehensive YouTube Data API v3 and Analytics integration for N8N workflows

Actions83

Overview

The "Get Video" operation of the "Videos" resource in this YouTube Enhanced node allows users to retrieve detailed information about a specific YouTube video by its unique Video ID. This operation is useful for workflows that need to fetch metadata, statistics, or other details about a particular video on YouTube.

Common scenarios where this node is beneficial include:

  • Automatically fetching video details to update databases or content management systems.
  • Integrating video data into marketing or analytics dashboards.
  • Triggering actions based on video metadata, such as publishing status or view counts.

For example, a user might input a YouTube Video ID to get the video's title, description, and statistics, then use that data downstream in their workflow to generate reports or trigger notifications.

Properties

Name Meaning
Video ID The unique identifier of the YouTube video to retrieve information for.
Max Results Maximum number of results to return (used in some operations; default is 25, max 50).
Page Token Pagination token to retrieve the next set of results if applicable.
Language Language code (e.g., "en", "pt") to specify language preferences for returned data.

Note: For the "Get Video" operation specifically, only the Video ID property is required and directly relevant.

Output

The output JSON contains the detailed response from the YouTube API for the requested video. This typically includes:

  • Video metadata such as title, description, tags, published date.
  • Statistics like view count, like count, dislike count, comment count.
  • Status information including privacy status and upload status.
  • Content details such as duration, definition quality, captions availability.

The output is structured as an array of items, each with a json field containing the video data object. There is no binary data output for this operation.

Example output snippet (simplified):

{
  "id": "VIDEO_ID",
  "snippet": {
    "title": "Video Title",
    "description": "Video description here...",
    "publishedAt": "2023-01-01T00:00:00Z",
    "tags": ["tag1", "tag2"]
  },
  "statistics": {
    "viewCount": "12345",
    "likeCount": "678",
    "commentCount": "90"
  },
  "status": {
    "privacyStatus": "public"
  }
}

Dependencies

  • Requires an active subscription and valid API key credential for the external N8N Tools API service.
  • Requires OAuth2 credentials or API credentials configured for YouTube Data API v3 access.
  • The node internally uses helper classes to interact with YouTube APIs and validate the subscription before making requests.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correct and has an active subscription.
  • Missing or Incorrect Video ID: Ensure the Video ID provided is valid and corresponds to an existing YouTube video.
  • API Quota Limits: YouTube API enforces quota limits; exceeding these may cause errors. Monitor usage and adjust accordingly.
  • Network or Permission Issues: Errors related to network connectivity or insufficient permissions can occur; ensure proper OAuth scopes and network access.

Links and References

Discussion