Traffic from Related Videos for a Video

This query provides detailed metrics about traffic coming from related videos for a specific YouTube video. It shows which videos are driving viewers to your content through YouTube's related videos recommendations.

Example Output

Parameters

Dimension

Specifies the traffic source detail:

• insightTrafficSourceDetail: Shows the specific videos that are driving traffic to your content.

Start Date

The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).

• Cannot be in the future.

End Date

The end date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-09-30).

• Cannot be in the future.
• Must be after Start Date.

Tip: For scheduled requests, you may need to update the date daily. Instead of specifying the date manually, you can use 'today' or 'yesterday' as the parameter. When the request runs, the date will automatically adjust to the desired day.

IDs

Specifies the channel for which to retrieve data.

• Options:
  • "channel==MINE": Fetches data for your own channel.
  • "channel==CHANNEL_ID": Retrieves data for a specific channel you own.

Sort (Optional)

Determines the order of results:

• Example:
  • "-estimatedMinutesWatched" for sorting by watch time in descending order.

Filters

Required filter combination:

• video==VIDEO_ID;insightTrafficSourceType==RELATED_VIDEO
• Replace VIDEO_ID with the ID of a video from your channel.

Maximum Results

Enter a number between 1 and 200 to control the number of results returned (default is 10).

Columns

• Dimension: The title or identifier of the related video driving traffic to your content.

• Views: Number of views received from each related video.

• Estimated Minutes Watched: The estimated total number of minutes that viewers coming from related videos spent watching your video.

• Average View Duration: Average time viewers from related videos spent watching your content, measured in minutes.

Notes

• This query specifically focuses on traffic from related videos, helping you understand which other YouTube content drives viewers to your video.
• Results are typically sorted by watch time to show the most impactful traffic sources first.
• The API supports pagination for retrieving more than 50 results through the maxResults parameter.