article_pageviews {pageviews}

Retrieve Pageview Data for an Article

Description

retrieves the pageview data for a particular article on a project, within a provided time-range.

Usage

article_pageviews(
  project = "en.wikipedia",
  article = "R (programming language)",
  platform = "all",
  user_type = "all",
  start = "2015100100",
  end = NULL,
  reformat = TRUE,
  granularity = "daily",
  ...
)

Arguments

project

the name of the project, structured as [language_code].[project] (see the default).

article

the article(s) you want to retrieve data for. Ideally features underscores in the title instead of spaces, but happily converts if you forget to do this.

platform

The platform the pageviews came from; One or more of "all", "desktop", "mobile-web" and "mobile-app". Set to "all" by default.

user_type

the type of users. One or more of "all", "user", "spider" or "bot". "all" by default.

start

the start YYYYMMDDHH of the range you want to cover. This can be easily grabbed from R date/time objects using pageview_timestamps.

end

the end YYYYMMDDHH of the range you want to cover. NULL by default, meaning that it returns 1 day of data.

reformat

Whether to reformat the results as a data.frame or not. TRUE by default.

granularity

the granularity of data to return; "daily" or "monthly", depending on whether pageview data should reflect trends in days or months.

...

further arguments to pass to httr's GET.

See Also

top_articles for the top articles per project in a given date range, and project_pageviews for per-project pageviews.

Examples

# Basic example
r_pageviews <- article_pageviews()

# Modify the article
obama_pageviews <- article_pageviews(article = "Barack_Obama")