wx_most_requested_files: Most requested files for a referer

Description Usage Arguments Value Media Limitations License See Also Examples

View source: R/mediareqs.R

Description

The most requested media files per referer and per media type.

Usage

1
2
3
4
5
6
7
wx_most_requested_files(
  referer,
  media_type = c("all", "image", "video", "audio", "document", "other"),
  granularity = c("daily", "monthly"),
  start_date = "20191231",
  end_date = "20200101"
)

Arguments

referer

The place that the request was made from. It can be any Wikimedia project (e.g. de.wikipedia), "all", "internal", "external", "search-engine", "unknown" or "none".

media_type

The media type that each file belongs to. It can be image, audio, video, document, or other. Default is "all" media types. See Media section below.

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:

date

Date; beginning of each month if granularity = "monthly"

referer

referer

file_path

the media file's path on upload.wikimedia.org

requests

number of requests

rank

requests-based ranking

Media

File types are obtained by parsing the file extension, and then classified according to the following table:

Extensions Media type
svg, png, tiff, tiff, jpeg, jpeg, gif, xcf, webp, bmp image
mp3, ogg, oga, flac, wav, midi, midi audio
webm, ogv video
pdf, djvu, srt, txt document
(all other extensions) other

Limitations

License

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

See Also

Other content data & metrics: wx_edited_pages(), wx_mediareqs_file(), wx_mediareqs_referer(), wx_new_pages(), wx_page_edits(), wx_project_edits(), wx_top_edited_pages(), wx_total_pages()

Other mediarequests data & metrics: wx_mediareqs_file(), wx_mediareqs_referer()

Examples

1
wx_most_requested_files("en.wikipedia", media_type = "video", granularity = "monthly")

bearloga/waxer documentation built on Nov. 28, 2020, 11:28 p.m.