I'd also recommend doing both. +1 to the schema proposed by Gabriel.

I'm sure it'll come up eventually but, just a few thoughts:

* Both can be cached (one can be cached for <24h, the other longer).
* The dynamic range allows useful linking to answer canonical questions regarding current trends.
* The dynamic range can either be a redirect resolved by the web app, or it can simply do the response directly (I recommend the latter; but either can cache for <24h). It should probably specify "link rel=canonical" (HTTP header or HTML tag, for machines) with the expanded url, and in case of a UI it can advertise this as the "Permalink" (for humans).

-- Timo


On Sat, Sep 12, 2015 at 1:11 AM, Sage Ross <ragesoss+wikipedia@gmail.com> wrote:
And, per Tgr on Phabricator, option 2 means that urls are stable, so I
can link to some data and expect it to show the same data later on.

-Sage

On Fri, Sep 11, 2015 at 5:08 PM, Jonathan Morgan <jmorgan@wikimedia.org> wrote:
> I would prefer to have both days-in-past and start/end daterange options,
> along the lines of Adam's proposal.
>
> But if I have to choose one, I concur with Leila. Start/end daterange offers
> more functionality.
>
> Jonathan
>
> On Fri, Sep 11, 2015 at 4:44 PM, Oliver Keyes <okeyes@wikimedia.org> wrote:
>>
>> Big +1 to Adam. Is the top articles the first deliverable we should
>> expect?
>>
>> On 11 September 2015 at 19:27, Gabriel Wicke <gwicke@wikimedia.org> wrote:
>> >
>> >
>> > On Fri, Sep 11, 2015 at 4:26 PM, Gabriel Wicke <gwicke@wikimedia.org>
>> > wrote:
>> >>
>> >> Another option would be a single entry point
>> >>
>> >> /top/{project}/{access}/from/{start}{/end}
>> >>
>> >> with support for negative indexes for 'days in the past':
>> >>
>> >> /top/{project}/{access}/from/-30
>> >> /top/{project}/{access}/from/-60/-30
>> >>
>> >> as well as full dates:
>> >>
>> >> /top/en.wikipedia/all-access/2014-06-12/2015-08-30
>> >
>> >
>> > Correction:
>> >
>> > /top/en.wikipedia/all-access/from/2014-06-12/2015-08-30
>> >
>> >>
>> >>
>> >>
>> >>
>> >>
>> >>
>> >>
>> >> On Fri, Sep 11, 2015 at 3:19 PM, <paul@paulweiss.info> wrote:
>> >>>
>> >>> I concur with Leila.
>> >>>
>> >>> Paul
>> >>>
>> >>>
>> >>> --------- Original Message ---------
>> >>> Subject: Re: [Analytics] [Survey] Pageview API
>> >>> From: "Leila Zia" <leila@wikimedia.org>
>> >>> Date: 9/11/15 3:06 pm
>> >>> To: "A mailing list for the Analytics Team at WMF and everybody who
>> >>> has
>> >>> an interest in Wikipedia and analytics."
>> >>> <analytics@lists.wikimedia.org>
>> >>>
>> >>> It's getting exciting. :-)
>> >>>
>> >>> I'd go with choice 2 since it gives more control to the user while
>> >>> offering what the user can get through choice 1 as well.
>> >>>
>> >>> Question: will we get page_ids or page_titles or both? It's good to
>> >>> have
>> >>> both.
>> >>>
>> >>> Leila
>> >>>
>> >>> On Fri, Sep 11, 2015 at 3:00 PM, Dan Andreescu
>> >>> <dandreescu@wikimedia.org>
>> >>> wrote:
>> >>>>
>> >>>> Hi everyone.  End of quarter is rapidly approaching and I wanted to
>> >>>> ask
>> >>>> a quick question about one of the endpoints we want to push out.  We
>> >>>> want to
>> >>>> let you ask "what are the top articles" but we're not sure how to
>> >>>> structure
>> >>>> the URL so it's most useful to you.  Here are the choices:
>> >>>>
>> >>>> Choice 1. /top/{project}/{access}/{days-in-the-past}
>> >>>>
>> >>>> Example: top articles via all en.wikipedia sites for the past 30
>> >>>> days:
>> >>>> /top/en.wikipedia/all-access/30
>> >>>>
>> >>>>
>> >>>> Choice 2. /top/{project}/{access}/{start}/{end}
>> >>>>
>> >>>> Example: top articles via all en.wikipedia sites from June 12th, 2014
>> >>>> to
>> >>>> August 30th, 2015: /top/en.wikipedia/all-access/2014-06-12/2015-08-30
>> >>>>
>> >>>>
>> >>>> (in all of those,
>> >>>>
>> >>>> * {project} means en.wikipedia, commons.wikimedia, etc.
>> >>>> * {access} means access method as in desktop, mobile web, mobile app
>> >>>>
>> >>>> )
>> >>>>
>> >>>> Which do you prefer?  Would any other query style be useful?
>> >>>>
>> >>>> _______________________________________________
>> >>>> Analytics mailing list
>> >>>> Analytics@lists.wikimedia.org
>> >>>> https://lists.wikimedia.org/mailman/listinfo/analytics
>> >>>
>> >>> _______________________________________________ Analytics mailing list
>> >>> Analytics@lists.wikimedia.org
>> >>> https://lists.wikimedia.org/mailman/listinfo/analytics
>> >>>
>> >>>
>> >>> _______________________________________________
>> >>> Analytics mailing list
>> >>> Analytics@lists.wikimedia.org
>> >>> https://lists.wikimedia.org/mailman/listinfo/analytics
>> >>>
>> >>
>> >>
>> >>
>> >> --
>> >> Gabriel Wicke
>> >> Principal Engineer, Wikimedia Foundation
>> >
>> >
>> >
>> >
>> > --
>> > Gabriel Wicke
>> > Principal Engineer, Wikimedia Foundation
>> >
>> > _______________________________________________
>> > Analytics mailing list
>> > Analytics@lists.wikimedia.org
>> > https://lists.wikimedia.org/mailman/listinfo/analytics
>> >
>>
>>
>>
>> --
>> Oliver Keyes
>> Count Logula
>> Wikimedia Foundation
>>
>> _______________________________________________
>> Analytics mailing list
>> Analytics@lists.wikimedia.org
>> https://lists.wikimedia.org/mailman/listinfo/analytics
>
>
>
>
> --
> Jonathan T. Morgan
> Senior Design Researcher
> Wikimedia Foundation
> User:Jmorgan (WMF)
>
>
> _______________________________________________
> Analytics mailing list
> Analytics@lists.wikimedia.org
> https://lists.wikimedia.org/mailman/listinfo/analytics
>

_______________________________________________
Analytics mailing list
Analytics@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/analytics