Skip to content

Search Video (by Video ID)

This query allows you to retrieve detailed information about YouTube videos searched by their video ID(s).

Parameters

Video(s) ID

The unique identifier(s) of the video(s) you want to search for. You can enter up to 50 video IDs as comma-separated values. Each video ID consists of 11 characters.

  • Example: vsCJpEnszYs,71PmTZOgmXA

Tip: How can I find the video ID of a YouTube video?

My rating

Only show videos that you have liked or disliked.

Tip: You can leave the Video ID parameter empty and selected "Liked" or "Disliked" for My Rating to get a list of all videos you have ever liked or disliked.

Maximum Results

Specifies the maximum number of results to return. The API natively supports 50 results for this type of query.

Note: Pagination allows Tube2Sheet to retrieve more than the 50 results natively supported by the YouTube API for this query type. When you request more than 50 results, Tube2Sheet automatically makes multiple API calls, each retrieving up to 50 results, to fulfill your request. Each of these calls counts separately against your monthly request quota, so requesting 500 results would use 10 requests from your quota.

Region Code

Filters results to videos that can be viewed in a specified country. Use a two-letter ISO 3166-1 alpha-2 country code.

  • Example: US for United States, IN for India
  • This parameter is optional and advanced.

Note: For a complete list of country codes, refer to the Wikipedia country code list.

Columns

The data returned from this query can be customized using various output columns. Columns are categorized into basic columns and advanced columns.

Note: Advanced columns are marked with the icon.

Basic Columns

These columns are included by default in the output:

  • Video ID: The unique identifier of the video.
  • Channel ID: The ID of the channel that uploaded the video.
  • Video Title: The title of the video.
  • Channel Name: The name of the channel that uploaded the video.
  • Views: The number of views the video has received.
  • Likes: The number of likes the video has received.
  • Comments: The number of comments on the video.

Advanced Columns

These columns provide additional details and are available for more in-depth data analysis:

  • eTag: Entity tag for the resource.
  • Kind ID: The type of resource, e.g., "youtube#video".
  • Published at: The date and time when the video was published.
  • Description: A brief description of the video.
  • Thumbnails: Various thumbnail URLs, widths, and heights (default, medium, high, standard, max res).
  • Tags: The tags associated with the video.
  • Category ID: The category of the video.
  • Live Broadcast Content: Information about whether the video is a live broadcast.
  • Default Language: The default language of the video.
  • Localized Title: The title of the video in the localized language.
  • Localized Description: The description of the video in the localized language.
  • Default Audio Language: The default audio language of the video.
  • Duration: The duration of the video.
  • Dimension: The dimension of the video (2D or 3D).
  • Definition: The definition of the video (e.g., HD or SD).
  • Caption: Information about whether the video has captions.
  • Licensed Content: Indicates whether the video contains licensed content.
  • Region Restriction blocked: Indicates if the video is blocked in certain regions.
  • Projection: The projection type of the video (e.g., 360-degree).
  • Content Rating: The content rating of the video.
  • Favorites: The number of times the video was marked as favorite.

For additional help, visit our FAQ or Troubleshooting sections.

-