GET Stats / Installs

Installs are returned as a feed of DateTime objects with counts next to them. These timestamps represent the beginning of an hour period, and the count is the number of installs that happened in that hour.

Endpoint URL: https://api.carnivalmobile.com/v6/stats/installs

Parameters

NameTypeRequiredDefinition
fromdatetimeBeginning date for range
todatetimeEnd date for range

Examples

Copy
# Default parameters (Last Month)
curl -XGET -i -u :$API_KEY -H 'Accept: application/json' https://api.carnivalmobile.com/v6/stats/installs

# With Parameters for To and From
curl -XGET -i -u :$API_KEY -H 'Accept: application/json' https://api.carnivalmobile.com/v6/stats/installs?from=2015-07-25&to=2015-07-28

Result Format

200 OK

Copy
[
  {
    "date": "2015-07-25T00:00:00.000Z",
    "count": 23543
  },
  {
    "date": "2015-07-26T00:00:00.000Z",
    "count": 66435
  },
  {
    "date": "2015-07-27T00:00:00.000Z",
    "count": 23542
  },
  {
    "date": "2015-07-28T00:00:00.000Z",
    "count": 35457
  }
]

401 Unauthorized

Copy
{
  "error":"unauthorized"}

403 Forbidden

Copy
{
  "error":"your api client does not have the correct roles"}

Date Format

This API endpoint uses the ISO 8601 DateTime format. Examples:
  • 2015-07-25 (Just date)
  • 2015-07-25T00:00:00.000+00:00 (Date, Time, Offset)

Note: When running the curl command with parameters, you should wrap the URL in double quotation mark.