Download Estimates

GET 75 Credits / Request + 25 Credits / Request / 30 days /android/applications/{APPLICATION_ID}/downloads.json

Based on the category of the given application, AppTweak can provide an estimation of its downloads on the selected period (dates range) in the chosen country.

Download Estimates Request

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the metadata.
Query parameters
country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

us. Get the list of our country codes, here.

start_date: date

Start date, format: YYYY-MM-DD

end_date: date

End date, format: YYYY-MM-DD

GET /android/applications/{APPLICATION_ID}/downloads.json

Request example
GET /android/applications/com.king.candycrushsodasaga/downloads.json?country=us&start_date=2018-11-01&end_date=2018-11-15
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/android/applications/com.king.candycrushsodasaga/downloads.json?country=us&start_date=2018-11-01&end_date=2018-11-15

Download Estimates Response

The response for the Download Estimates request is a JSON hash containing all the values calculated by AppTweak for the given application in the selected country and period (dates range) on the Google Play Store.

Object properties
country_code (e.g. us): array

Key/value pairs containing the history of the downloads estimates on the selected period.

CHILD PROPERTIES

start_date: datetime

Start date for the selected period.

end_date: datetime

End date for the selected period.

downloads: array

Array of numbers (integer) listing all the download estimate for each day on the selected period.

precisions: array

Array of numbers (float) listing the AppTweak confidence about the calculated download estimate for each day on the selected period.

Response Example

{
  "content": {
    "us": [
      {
        "start_date": "2018-11-01",
        "end_date": "2018-11-15",
        "downloads": [
          6825,
          6412,
          7165,
          7079,
          6824,
          6731,
          6975,
          7215,
          6783,
          6246,
          5572,
          4803,
          4809,
          5962,
          6401
        ],
        "precision": [
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274,
          0.8921001926782274
        ]
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/applications/com.king.candycrushsodasaga/downloads.json",
      "store": "android",
      "params": {
        "country": "us",
        "start_date": "2018-11-01T00:00:00+00:00",
        "end_date": "2018-11-15T00:00:00+00:00",
        "apply_seasonality": true,
        "id": "com.king.candycrushsodasaga",
        "format": "json"
      },
      "performed_at": "2018-11-27 00:59:00 UTC"
    },
    "content": {
    }
  }
}