-
Notifications
You must be signed in to change notification settings - Fork 54
/
README.Rmd
87 lines (60 loc) · 3.63 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
set.seed(1014)
```
## :sweet_potato: tuber: Access YouTube API via R
[](https://ci.appveyor.com/project/soodoku/tuber)
[](https://travis-ci.org/soodoku/tuber)
[](https://cran.r-project.org/package=tuber)
[](https://codecov.io/gh/soodoku/tuber)
Access YouTube API via R. Get comments posted on YouTube videos, get information on how many times a video has been liked, search for videos with particular content, and much more. You can also get closed captions of videos you own. To learn more about the YouTube API, see [https://developers.google.com/youtube/v3/](https://developers.google.com/youtube/v3/).
### Installation
To get the current development version from GitHub:
```{r, eval = FALSE}
# install.packages("devtools")
devtools::install_github("soodoku/tuber", build_vignettes = TRUE)
```
To get a quick overview of some important functions in tuber, check out [this article](http://soodoku.github.io/tuber/articles/tuber-ex.html). For a fun vignette about how to analyze emojis in YouTube comments, see [here](http://soodoku.github.io/tuber/articles/emoji_vignette.html).
### Using tuber
To get going, get the application id and password from the Google Developer Console (see [https://developers.google.com/youtube/v3/getting-started](https://developers.google.com/youtube/v3/getting-started)). Enable all the YouTube APIs. Then set the application id and password via the `yt_oauth` function. For more information about YouTube OAuth, see [YouTube OAuth Guide](https://developers.google.com/youtube/v3/guides/authentication).
```{r, eval = FALSE}
yt_oauth("app_id", "app_password")
```
**Note:** If you are on ubuntu, you may have to run the following before doing anything:
```
httr::set_config(httr::config( ssl_verifypeer = 0L ) )
```
**Get Statistics of a Video**
```{r, eval = FALSE}
get_stats(video_id = "N708P-A45D0")
```
**Get Information About a Video**
```{r, eval = FALSE}
get_video_details(video_id = "N708P-A45D0")
```
**Get Captions of a Video**
```{r, eval = FALSE}
get_captions(video_id = "yJXTXN4xrI8")
```
**Note**: It was previously possible to get captions for all videos that had "Community contributions" enabled. However, since [*YouTube* removed that option in September 2020](https://support.google.com/youtube/answer/6052538?hl=en), the `get_captions` function now only works for videos created with the same account as the API credentials you use. An alternative for collecting *YouTube* video captions is the [*youtubecaption* package](https://github.com/jooyoungseo/youtubecaption).
**Search Videos**
```{r, eval = FALSE}
yt_search("Barack Obama")
```
**Get All the Comments Including Replies**
```{r, eval = FALSE}
get_all_comments(video_id = "a-UQz7fqR3w")
```
### License
Scripts are released under the [MIT License](http://opensource.org/licenses/MIT).
### Contributor Code of Conduct
The project welcomes contributions from everyone! In fact, it depends on it. To maintain this welcoming atmosphere, and to collaborate in a fun and productive way, we expect contributors to the project to abide by the [Contributor Code of Conduct](http://contributor-covenant.org/version/1/0/0/).