---------- Forwarded message ----------
From: Dan Andreescu <dandreescu(a)wikimedia.org
<mailto:dandreescu@wikimedia.org>>
To: Research into Wikimedia content and communities
<wiki-research-l(a)lists.wikimedia.org
<mailto:wiki-research-l@lists.wikimedia.org>>
Cc:
Date: Wed, 18 Nov 2015 08:43:10 -0500
Subject: Pageview API
Dear Data Enthusiasts,
In collaboration with the Services team, the analytics team wishes to announce a public
Pageview API
<https://wikimedia.org/api/rest_v1/?doc#!/Pageviews_data/get_metrics_pageviews_per_article_project_access_agent_article_granularity_start_end>.
For an example of what kind of UIs someone could build with it, check out this excellent
demo <http://analytics.wmflabs.org/demo/pageview-api> (code)
<https://gist.github.com/marcelrf/49738d14116fd547fe6d#file-article-comparison-html>.
The API can tell you how many times a wiki article or project is viewed over a certain
period. You can break that down by views from web crawlers or humans, and by desktop,
mobile site, or mobile app. And you can find the 1000 most viewed articles
<https://wikimedia.org/api/rest_v1/metrics/pageviews/top/es.wikipedia/all-access/2015/11/11>
on any project, on any given day or month that we have data for. We currently have data
back through October and we will be able to go back to May 2015 when the loading jobs are
all done. For more information, take a look at the user docs
<https://wikitech.wikimedia.org/wiki/Analytics/AQS/Pageview_API>.
After many requests from the community, we were really happy to finally make this our top
priority and get it done. Huge thanks to Gabriel, Marko, Petr, and Eric from Services,
Alexandros and all of Ops really, Henrik for maintaining stats.grok, and, of course, the
many community members who have been so patient with us all this time.
The Research team’s Article Recommender tool <http://recommend.wmflabs.org/> already
uses the API to rank pages and determine relative importance. Wiki Education Foundation’s
dashboard <https://dashboard.wikiedu.org/> is going to be using it to count how many
times an article has been viewed since a student edited it. And there are other grand
plans for this data like “article finder”, which will find low-rated articles with a lot
of pageviews; this can be used by editors looking for high-impact work. Join the fun,
we’re happy to help get you started and listen to your ideas. Also, if you find bugs or
want to suggest improvements, please create a task in Phabricator and tag it with
#Analytics-Backlog <https://phabricator.wikimedia.org/tag/analytics-backlog/>.
So what’s next? We can think of too many directions to go into, for pageview data and
Wikimedia project data, in general. We need to work with you to make a great plan for the
next few quarters. Please chime in here <https://phabricator.wikimedia.org/T112956>
with your needs.
Team Analytics
(p.s. this was also posted on analytics-l, wikitech-l, and engineering-l, but I suck and
forgot to cc the research list. My apologies.)
Dario Taraborelli Head of Research, Wikimedia Foundation
wikimediafoundation.org <http://wikimediafoundation.org/> •
nitens.org
<http://nitens.org/> • @readermeter <http://twitter.com/readermeter>