gtrendsR Travis-CI Build Status AppVeyor 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.

Due to recent changes to Google Trends API, the CRAN version of the package is no longer working. If you want to continue to query Google Trends, you have to install the development version of the package. This will be soon deployed on CRAN.


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


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


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


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")

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



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


Philippe Massicotte and Dirk Eddelbuettel


GPL (>= 2)