tuber (version 1.4.1)

get_stats: Get statistics of a Video or Videos

Description

Gets view count, like count, comment count and other statistics for YouTube video(s). For unlisted videos, you must use OAuth authentication with the channel owner's credentials. Automatically uses batch processing when multiple video IDs are provided for efficiency.

Usage

get_stats(
  video_ids = NULL,
  include_content_details = FALSE,
  batch_size = 50,
  simplify = TRUE,
  ...
)

Value

For single video: list with elements id, viewCount, likeCount, dislikeCount, favoriteCount, commentCount. When include_content_details = TRUE, also includes duration, definition, dimension, licensedContent, projection. For multiple videos: data frame with one row per video (if simplify=TRUE) or list of results.

Arguments

video_ids

Character vector. One or more video IDs. Required.

include_content_details

Boolean. Include contentDetails (duration, definition, etc.) in response. Default: FALSE.

batch_size

Integer. Number of videos per API call when batching (max 50). Default: 50.

simplify

Boolean. Return simplified data frame for multiple videos. Default: TRUE.

...

Additional arguments passed to tuber_GET.

References

https://developers.google.com/youtube/v3/docs/videos/list#parameters

Examples

if (FALSE) {

# Set API token via yt_oauth() first

# Single video
get_stats(video_ids="N708P-A45D0")

# Multiple videos (automatic batching)
video_ids <- c("N708P-A45D0", "M7FIvfx5J10", "kJQP7kiw5Fk")
stats_df <- get_stats(video_ids)

# Include video duration and other content details:
get_stats(video_ids="N708P-A45D0", include_content_details = TRUE)

# For unlisted videos, must authenticate as channel owner:
# yt_oauth("your_client_id", "your_client_secret")
# get_stats(video_ids="your_unlisted_video_id")
}