​
Overview

The Youtube API Suite offers multiple types of APIs, each designed for specific data collection needs from Youtube. Below is an overview of how these APIs connect and interact, based on the available features:

Posts API

This API allows users to collect multiple posts based on a single input URL.


  •   Discovery functionality:
  •   Discover by keywords.
  •   Discover by search filters.
  •   Discover by hashtag.
  •   Discover by channel URL.

  •   Interesting Columns:
  •   url, title, likes, views.

Comments API

This API allows users to collect multiple comments from a post using its URL.


  •   Discovery functionality:
  •   N/A

  •   Interesting Columns:
  •   comment_text, replies, likes, username.

​
Profiles API

​
Collect by URL

This API allows users to retrieve detailed YouTube channel information using the provided channel URL.

Input Parameters

​
URL
string
required

The YouTube channel URL.

Output Structure
Includes comprehensive data points:

  • Profile Details:
    url, handle, name, description, created_date, identifier, id, handle_md5.

  • Engagement Metrics:
    subscribers, videos_count, views.

    For all data points, click here.

  • Media Assets:
    profile_image, banner_img.

    For all data points, click here.

  • Additional Information:
    details, links, discovery_input.

This API provides insights into YouTube channel profiles, including engagement metrics, profile assets, and detailed channel information.

​
Discover by Keywords

This API allows users to discover YouTube channel profiles by searching with specific keywords related to the channel or its videos.

Input Parameters

​
keyword
string
required

Keyword related to the channel or its videos.

Output Structure
Includes comprehensive data points:

  • Profile Details:
    url, handle, name, description, created_date, identifier, id, handle_md5.

    For all data points, click here.

  • Engagement Metrics:
    subscribers, videos_count, views.

  • Media Assets:
    profile_image, banner_img.

  • Additional Information:
    details, links, discovery_input.

This API enables efficient discovery of YouTube channel profiles based on keywords, providing profile information, engagement metrics, and related details.

​
Posts API

​
Collect by URL

This API allows users to retrieve detailed video information from YouTube using the provided video URL.

Input Parameters

​
URL
string
required

The YouTube video URL.

Output Structure
Includes comprehensive data points:

  • Video Details:
    url, title, video_url, video_length, video_id, post_type, date_posted, description, music, transcript, formatted_transcript.

    For all data points, click here.

  • Engagement Metrics:
    likes, views, num_comments, related_videos.

  • Channel Details:
    youtuber, youtuber_id, handle_name, channel_url, subscribers, verified, avatar_img_channel, youtuber_md5.

  • Video Media & Quality:
    preview_image, viewport_frames, current_optimal_res, codecs, color, quality, quality_label.

  • Additional Information:
    discovery_input, shortcode, is_sponsored, license.

This API enables users to retrieve detailed insights about a YouTube video, including metadata, engagement metrics, and channel-specific details, supporting content analysis and tracking.

​
Discover by Channel URL

This API allows users to collect videos published by a specific YouTube channel using its URL, with optional filters like the number of posts, date range, and sorting order.

Input Parameters

​
URL
string
required

The YouTube channel URL.

​
num_of_posts
number

The number of videos to collect. If omitted, there is no limit.

​
start_date
string

Start date for filtering videos (MM-DD-YYYY).

​
end_date
string

End date for filtering videos (MM-DD-YYYY).

​
order_by
string

Sort the results (e.g., by views, date, or relevance).

Output Structure
Includes comprehensive data points:

  • Video Details:
    url, title, video_url, video_id, video_length, date_posted, description, post_type.

    For all data points, click here.

  • Channel Details:
    youtuber, youtuber_id, channel_url, handle_name, avatar_img_channel, subscribers, youtuber_md5, verified.

  • Engagement Metrics:
    likes, views, num_comments, is_sponsored.

  • Media and Technical Information:
    preview_image, related_videos, music, shortcode, viewport_frames, current_optimal_res, codecs, color, quality, quality_label, license.

  • Transcript:
    transcript, formatted_transcript.

This API allows efficient retrieval of YouTube videos from a specified channel with detailed video, channel, and engagement information, supporting filtering and sorting options for enhanced analysis.

​
Discover by Keywords

This API allows users to search for YouTube videos using specific keywords, with optional parameters for filtering results by date range and the number of posts to retrieve.

Input Parameters

​
keyword
string
required

The keyword to search for videos.

​
num_of_posts
number

The number of videos to collect.

​
start_date
string

Start date for filtering videos (MM-DD-YYYY).

​
end_date
string

End date for filtering videos (MM-DD-YYYY).

Output Structure
Includes comprehensive data points:

  • Video Details:
    url, title, video_url, video_id, video_length, date_posted, description, post_type.

    For all data points, click here.

  • Channel Details:
    youtuber, youtuber_id, channel_url, handle_name, avatar_img_channel, subscribers, youtuber_md5, verified.

  • Engagement Metrics:
    likes, views, num_comments, is_sponsored.

  • Media and Technical Information:
    preview_image, related_videos, music, shortcode, viewport_frames, current_optimal_res, codecs, color, quality, quality_label, license.

  • Transcript:
    transcript, formatted_transcript.

This API enables efficient discovery of YouTube videos using keywords, supporting advanced filtering by date and result count for targeted video analysis and retrieval.

​
Discover by Search Filters

This API allows users to search for YouTube videos using advanced search filters such as upload date, video type, duration, and additional features, enabling more refined and targeted video discovery.

Input Parameters

​
keyword_search
string
required

The keyword to search for videos.

​
upload_date
string

Filter results by upload date (e.g., today, this week, this month).

​
type
string

Specify video type (e.g., video, channel, playlist).

​
duration
string

Filter by video length (e.g., short, medium, long).

​
features
string

Specify additional video features (e.g., 4K, HD, subtitles, live).

Output Structure
Includes comprehensive data points:

  • Video Details:
    url, title, video_url, video_id, video_length, date_posted, description, post_type.

    For all data points, click here.

  • Channel Details:
    youtuber, youtuber_id, channel_url, handle_name, avatar_img_channel, subscribers, youtuber_md5, verified.

  • Engagement Metrics:
    likes, views, num_comments, is_sponsored.

  • Media and Technical Information:
    preview_image, related_videos, music, shortcode, viewport_frames, current_optimal_res, codecs, color, quality, quality_label, license.

  • Transcript:
    transcript, formatted_transcript.

This API supports advanced search capabilities on YouTube, allowing users to filter results by multiple parameters for precise and efficient video discovery.

​
Discover by Hashtag

This API allows users to search for YouTube posts by a specific hashtag, enabling users to discover videos related to trending topics or specific themes.

Input Parameters

​
hashtag
string
required

The hashtag to search for (e.g., #fitness, #travel).

​
num_of_posts
number

The number of posts to collect. If omitted, there is no limit.

​
posts_to_not_include
array

An array of post IDs to exclude from the results.

​
start_date
string

Start date for filtering posts in MM-DD-YYYY format (should be earlier than end_date).

​
end_date
string

End date for filtering posts in MM-DD-YYYY format (should be later than start_date).

Output Structure
Includes comprehensive data points:

  • Video Details:
    url, title, video_url, video_id, video_length, date_posted, description, post_type.

    For all data points, click here.

  • Channel Details:
    youtuber, youtuber_id, channel_url, handle_name, avatar_img_channel, subscribers, youtuber_md5, verified.

  • Engagement Metrics:
    likes, views, num_comments, is_sponsored.

  • Media and Technical Information:
    preview_image, related_videos, music, shortcode, viewport_frames, current_optimal_res, codecs, color, quality, quality_label, license.

  • Transcript:
    transcript, formatted_transcript.

This API enables efficient video discovery by searching posts related to a specific hashtag, with filtering options to refine the results.

​
Comments API

​
Collect by URL

This API allows users to retrieve detailed comment data from a specific YouTube video using the provided video URL.

Input Parameters

​
URL
string
required

The YouTube video URL.

​
load_replies
number

Number of times to load replies for comments.

Output Structure
Includes comprehensive data points:

  • Comment Details:
    comment_id, comment_text, likes, replies, replies_value, replies_without_names.

    For all data points, click here.

  • User Details:
    username, user_channel, username_md5.

  • Additional Information:
    date, url, video_id.

This API enables users to analyze YouTube video comments, including replies and user details, providing insights into engagement and audience interactions.

Was this page helpful?

VimeoFAQs