YTAnalytics: R Wrapper for YouTube Analytics API



YTAnalytics is an R package designed to simplify data collection using the YouTube Analytics API. You can use this to get channel, playlist, and video data for your YouTube channel - just like what is found in YouTube Studio. Helpful data includes: * Video/Playlist/Channel Statistics * Daily/Monthly Views * Location Data (Country/City) * Demographics (Age/Gender) * Devices * Traffic Sources * Sharing Services * etc. etc.


YTAnalytics is built around one main function - analytics_request() which acts as the wrapper for the YouTube Analytics API. youtube_GET simplifies making GET requests using httr::GET and structuring the returned data in a data.frame.

data_channel_request(), data_playlist_request(), data_playlistItem_request(), and data_video_request() are wrappers for the YouTube Data API, meant only to help in getting some high level data or returning lists of videos in a channel or playlist. For this purpose, added functionality is not present. For more YouTube Data API functionality, refer here for the tuber package. To learn more about the YouTube Analytics API or to experiment with their built-in app, check them out here.


The most up-do-date version can be found on Github:

# install.packages("devtools")


In order to use the YouTube APIs, you need do the following: 1. Create a Project in your Google Developers Console. 2. Enable the YouTube Data and YouTube Analytics APIs in the developer library. 3. Create an OAuth consent screen. 4. Create OAuth authorization credentials. A more thorough walkthrough of this process can be found here (coming soon).

Once you have your client Id and Secret, use them in youtube_oauth() like the following:

youtube_oauth(clientId = YOURAPPID, clientSecret = YOURAPPSECRET)

An authentication token is created (by default called .httr-oauth) and saved in your working directory.

How To Use

Once authenticated, there are many functions to choose from. Functions are mostly categorized in three categories: channel, ‘playlist’, and video data. Each function leads with the category name followed by the particular function. For example:


# To get views, averageViewDuration, estimatedMinutesWatched, shares, likes, 
# dislikes, comments, subscribersGained & subscribersLost
# From Jan 1, 2000 - Today

# For Jan 1, 2020 - Jan 1, 2021
channel_stats(startDate = "2020-01-01", endDate = "2021-01-01")

# To get only views, averageViewDuration and estimatedMinutesWatched for all time
channel_stats(metrics = "views,averageViewDuration,estimatedMinutesWatched").  #Note that there are no spaces between metrics



playlist_daily_views(playlistId = myPlaylist)

playlist_live_onDemand(playlistId = myPlaylist)



video_audience_retention(videoId = myVideo)

video_top_countries(videoId = myVideo)

If none of these pre-built functions do quite what you need, you can always refer back to the analytics_request() function for more custom requests.

analytics_request(dimensions = "country",
                  metrics = "views",
                  filter = "video==YOURVIDEO",
                  sort = "-views",
                  maxResults = 50)

All Functions Currently Available