Curl

Download Estimates

GET 75 Credits / Request + 25 Credits / Request / 30 days /ios/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 Required

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

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

device: string iphone

The device you want to fetch the application for.

iphone or ipad

start_date: date

Start date, format: YYYY-MM-DD

end_date: date

End date, format: YYYY-MM-DD

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

Request example 
GET /ios/applications/618783545/downloads.json?country=es&start_date=2018-09-01&end_date=2018-09-15&device=iphone
cURL example 
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" "https://api.apptweak.com/ios/applications/618783545/downloads.json?country=es&start_date=2018-09-01&end_date=2018-09-15&device=iphone"

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 App Store.

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

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

CHILD PROPERTIES

device: array

The list of devices the app is available on. Can contain : ipad, ipod and iphone.

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": {
    "es": [
      {
        "start_date": "2018-09-01",
        "end_date": "2018-09-15",
        "device": "ipad",
        "downloads": [
          10,
          6,
          10,
          10,
          13,
          13,
          22,
          16,
          15,
          15,
          9,
          4,
          5,
          14,
          14
        ],
        "precision": [
          0.8422911773404118,
          0.8508253873707806,
          0.8422911773404118,
          0.8422911773404118,
          0.8422911773404118,
          0.8270306620727836,
          0.8735066032970483,
          0.8270306620727836,
          0.8270306620727836,
          0.8270306620727836,
          0.8422911773404118,
          0.8508253873707806,
          0.8508253873707806,
          0.8422911773404118,
          0.8270306620727836
        ]
      },
      {
        "start_date": "2018-09-01",
        "end_date": "2018-09-15",
        "device": "iphone",
        "downloads": [
          51,
          50,
          102,
          121,
          154,
          169,
          150,
          71,
          59,
          121,
          152,
          128,
          136,
          135,
          80
        ],
        "precision": [
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8268536235533313,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338,
          0.8197487478028338
        ]
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/applications/618783545/downloads.json",
      "store": "ios",
      "params": {
        "country": "es",
        "start_date": "2018-09-01T00:00:00+00:00",
        "end_date": "2018-09-15T00:00:00+00:00",
        "apply_seasonality": true,
        "id": "618783545",
        "format": "json"
      },
      "performed_at": "2018-11-21 16:41:29 UTC"
    },
    "content": {
    }
  }
}