Number of edits for given page(s) and timespan. Note: Due to performance of the data-serving backend, this API endpoint limits the queryable timespan to one year (whether in daily or monthly granularity).

wx_page_edits(
  project,
  page_name,
  editor_type = c("all", "anonymous", "user", "bot", "bot group"),
  granularity = c("daily", "monthly"),
  start_date = "20191101",
  end_date = "20200101"
)

Arguments

project

The name of any Wikimedia project formatted like {language code}.{project name}, for example en.wikipedia. You may pass en.wikipedia.org and the .org will be stripped off. For projects like Wikimedia Commons (without language codes), use commons.wikimedia. For projects like www.mediawiki.org, you can use that full string, or just use mediawiki or mediawiki.org.

page_name

The title of any article in the specified project. The function takes care of replacing spaces with underscores and URI-encoding, so that non-URI-safe characters like %, / or ? are accepted -- e.g. "Are You the One?" becomes "Are_You_the_One%3F". Internally this is done with a non-exported wx_encode_page_name function. If you need to get the pageviews for multiple pages, you're encouraged to provide all the page names at once as this function has been optimized for that use-case.

editor_type

If you want to filter by editor-type, use one of "anonymous", "group-bot" (registered accounts belonging to the bot group), "name-bot" (registered accounts not belonging to the bot group but having bot-like names) or "user" (registered account not in bot group nor having bot-like name). If you are interested in edits regardless of their editor type, use "all-editor-types" (default).

granularity

The time unit for the response data. As of today, supported values are daily (default) and monthly.

start_date

The date of the first day to include, in YYYYMMDD format. Can also be a Date or a POSIXt object, which will be auto-formatted.

end_date

The date of the last day to include, in YYYYMMDD format. Can also be a Date or a POSIXt object, which will be auto-formatted.

Value

A tibble data frame with the following columns:

project

project

page_name

page name

date

Date

edits

Number of edits made to the page

Granularity

For "monthly" granularity, the start_date and end_date need to contain the full month.

For example, start_date = "20191101" and end_date = "20191231" would only give the monthly total for 2019-11. To include 2019-12, use end_date = "20200101".

Frustratingly, start_date = "20191201" and end_date = "20191231" does not yield 2019-12 monthly total. Use end_date = "20200101" for that.

License

Data retrieved from the API endpoint is available under the CC0 1.0 license.

See also

Examples

if (FALSE) { wx_page_edits( "en.wikipedia", c("Animal Crossing: New Horizons", "Animal Crossing"), granularity = "monthly", start_date = "20190101", end_date = "20191231" ) }