R package to query the Google Ngram Viewer
Clone or download
seancarmody Merge pull request #24 from karafso/master
Changed getURL() to equivalent GET() call.
Latest commit a58603b Jan 20, 2017
Failed to load latest commit information.
R Changed getURL() to equivalent GET() call. Nov 18, 2016
man Updated docs again Apr 12, 2015
.Rbuildignore Ignore cran-comments.md in package Apr 12, 2015
.gitignore Remove README.md from CRAN Sep 4, 2013
.travis.yml Added travis CI config for automated linux testing Apr 13, 2015
DESCRIPTION Update details of pull request changes Apr 12, 2015
NEWS Note travis CI in NEWS Apr 13, 2015
README.md Update README.md Oct 21, 2013
cran-comments.md Initial submit of cran-comments.md Apr 12, 2015



R package to query the Google Ngram Viewer

The package has been updated to deal with the change to Google's website.

Note: with the switch to using RCurl to access SSL pages, ngramr will generally no longer work behind a proxy.

The Google Books Ngram Viewer allows you to enter a list of phrases and then displays a graph showing how often the phrases have occurred in a large corpus of books (e.g., "British English", "English Fiction", "French") over time. The current corpus collected in 2012 contains almost half a trillion words for English alone.

The underlying data is hidden in Web page, embedded in some Javascript. This package extracts the data and provides it in the form of an R dataframe. The code was adapted from a handy Python script available from Culturomics. It was written by Jean-Baptiste Michel.


This package required R version 2.15 or higher. If you are using an older version of R you will be prompted to upgrade when you try to install the package, so you may as well upgrade now!

The official release of ngramr is available on CRAN. To istall from CRAN, use the following command:


If you have any problems installing the package on OSX, try installing from source:

install.packages("ngramr", type="source")

If you have devtools installed, install the latest stable version this package directly from GitHub:

install_github("ngramr", "seancarmody")

and if you are feeling a little more adventurous, you can install the development version:

install_github("ngramr", "seancarmody", "develop")

although it may not always work.

If you are behind a proxy, install_github may not work for you. Instead of fiddling around with the RCurl proxy settings, you can download the ZIP archive and use install_local instead.


Here is an example of how to use the ngram function:

ng  <- ngram(c("hacker", "programmer"), year_start = 1950)
ggplot(ng, aes(x=Year, y=Frequency, colour=Phrase)) +

The result is a ggplot2 line graph of the following form:

Ngram Chart

The same result can be achieved even more simply by using the ggram plotting wrapper that supports many options, as in this example:

Ngram chart, with options

ggram(c("monarchy", "democracy"), year_start = 1500, year_end = 2000, 
      corpus = "eng_gb_2012", ignore_case = TRUE, 
      geom = "area", geom_options = list(position = "stack")) + 
      labs(y = NULL)

The colors used by Google Ngram are available through the google_theme option, as in this example posted by Ben Zimmer at Language Log:

Ngram chart, with Google theme

ng <- c("((The United States is + The United States has) / The United States)",
      "((The United States are + The United States have) / The United States)")
ggram(ng, year_start = 1800, google_theme = TRUE) +
  theme(legend.direction = "vertical")

Further Reading

For more information, read this Stubborn Mule post and the Google Ngram syntax documentation. If you would rather work with R and SQL on the raw Google Ngram datasets, see this post.