Home

Awesome

gtrendsR

GitHub Actions Build Status License CRAN Downloads

gtrendsR provides an interface for retrieving and displaying Google Trends information.

Trends (number of hits) over time as well as geographic representation of the results can be displayed.

Example

In this simple example, trends for keywords nhl, nba are retrieved for Canada and USA and then plotted from R.

library(gtrendsR)

res <- gtrends(c("nhl", "nba"), geo = c("CA", "US"))
plot(res)

Installation

Since release 1.3.0, the package is on CRAN and can be installed via

install.packages("gtrendsR")

Release-candidate packages are available in the ghrr drat repository and can installed via

install.packages("drat")       # easier repo access + creation
drat:::add("ghrr")             # make it known
install.packages("gtrendsR")   # install it

Development version (which may be less stable) can be installed directly from this repository via

if (!require("devtools")) install.packages("devtools")
devtools::install_github("PMassicotte/gtrendsR")

Using gtrendsR behind a PROXY.

If gtrendsR should be used behind a proxy, especially with NTLM authentication mode, you need to set the proxy parameters using "setHandleParameters" function

Example

library(gtrendsR)

setHandleParameters(user = "xxxx", password = "*******", domain = "mydomain", proxyhost = "10.111.124.113", proxyport = 8080)
res <- gtrends(c("nhl", "nba"), geo = c("CA", "US"))

Additional information

Authors

Philippe Massicotte and Dirk Eddelbuettel

License

GPL (>= 2)