Recent changes to Download Stats API

Download Stats API modified by Dave Brondsema

Dave Brondsema — Wed, 13 Apr 2022 18:57:48 -0000

--- v7
+++ v8
@@ -1,6 +1,6 @@
 The API uses URLs very similar to the existing stats URLs.  Here's an example:

-https://sourceforge.net/projects/openofficeorg.mirror/files/stats/json?start_date=2014-10-29&end_date=2014-11-04
+https://sourceforge.net/projects/openofficeorg.mirror/files/stats/json?start_date=2014-10-29&end_date=2014-11-04

 To access project-wide stats, use /files/stats/json in the URL.  To limit to a file or folder, use /files/some/path/stats/json

Download Stats API modified by SourceForge Support

SourceForge Support — Thu, 04 Nov 2021 17:46:56 -0000

--- v6
+++ v7
@@ -8,7 +8,7 @@

 * `start_date` - required, date in YYYY-MM-DD format
 * `end_date` - required, date in YYYY-MM-DD format
-* `period` - optional, control the level of detail in the results.  Automatically defaults based on size of date range.  May specify "daily" "weekly" or "monthly"
+* `period` - optional, control the level of detail in the results.  Automatically defaults based on the size of the date range.  May specify "daily" "weekly" or "monthly"
 * `os_by_country` - optional, include OS by Country breakdown.  On by default.  For a small performance improvement, pass `os_by_country=false`.
 * `country_codes` - optional, use 2-letter country codes in result.  Default is to use country names.

Download Stats API modified by Dave Brondsema

Dave Brondsema — Wed, 14 Mar 2018 22:12:57 -0000

--- v5
+++ v6
@@ -1,5 +1,3 @@
-Download Stats are temporarily delayed as we finalize our transition to a completely new datacenter.  We are continuing to collect data and will backfill when the service is fully restored.  Thank you for your patience.
-
 The API uses URLs very similar to the existing stats URLs.  Here's an example:

 https://sourceforge.net/projects/openofficeorg.mirror/files/stats/json?start_date=2014-10-29&end_date=2014-11-04

Download Stats API modified by Dave Brondsema

Dave Brondsema — Wed, 21 Feb 2018 17:29:26 -0000

--- v4
+++ v5
@@ -1,3 +1,5 @@
+Download Stats are temporarily delayed as we finalize our transition to a completely new datacenter.  We are continuing to collect data and will backfill when the service is fully restored.  Thank you for your patience.
+
 The API uses URLs very similar to the existing stats URLs.  Here's an example:

 https://sourceforge.net/projects/openofficeorg.mirror/files/stats/json?start_date=2014-10-29&end_date=2014-11-04

Download Stats API modified by Dave Brondsema

Dave Brondsema — Mon, 18 Dec 2017 16:27:56 -0000

--- v3
+++ v4
@@ -2,7 +2,15 @@

 https://sourceforge.net/projects/openofficeorg.mirror/files/stats/json?start_date=2014-10-29&end_date=2014-11-04

-The url parameters start_date and end_date are required and must be dates in YYYY-MM-DD format.  To access project-wide stats, use /files/stats/json in the URL.  To limit to a file or folder, use /files/some/path/stats/json
+To access project-wide stats, use /files/stats/json in the URL.  To limit to a file or folder, use /files/some/path/stats/json
+
+URL parameters:
+
+* `start_date` - required, date in YYYY-MM-DD format
+* `end_date` - required, date in YYYY-MM-DD format
+* `period` - optional, control the level of detail in the results.  Automatically defaults based on size of date range.  May specify "daily" "weekly" or "monthly"
+* `os_by_country` - optional, include OS by Country breakdown.  On by default.  For a small performance improvement, pass `os_by_country=false`.
+* `country_codes` - optional, use 2-letter country codes in result.  Default is to use country names.

 The return data is in JSON format.  The data should be pretty self-explanatory.  A few notes:

Download Stats API modified by Dave Brondsema

Dave Brondsema — Wed, 29 Jul 2015 19:59:08 -0000

--- v2
+++ v3
@@ -1,6 +1,6 @@
 The API uses URLs very similar to the existing stats URLs.  Here's an example:

-http://sourceforge.net/projects/xbmc/files/XBMC%20Live/stats/json?start_date=2010-05-01&end_date=2010-05-11
+https://sourceforge.net/projects/openofficeorg.mirror/files/stats/json?start_date=2014-10-29&end_date=2014-11-04

 The url parameters start_date and end_date are required and must be dates in YYYY-MM-DD format.  To access project-wide stats, use /files/stats/json in the URL.  To limit to a file or folder, use /files/some/path/stats/json

WikiPage Download Stats API modified by Dave Brondsema

Dave Brondsema — Thu, 05 Jul 2012 13:25:35 -0000

--- v1
+++ v2
@@ -9,4 +9,5 @@
 * "messages" may contain a list of informational messages, e.g. the date range was adjusted due to out of bounds start/end date
 * "period" contains one of daily, weekly, monthly.  This is auto-selected based on the size of the date range, and the "downloads" list will contain days, weeks, or months respectively
 * "countries" uses full names
+* "stats_updated" is a timestamp.  Stats have been updated up to that point in time.
 * all dates are UTC