v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

App Downloads - Legacy

Returns the number of times an app was downloaded from the Google Play/ Apple App store over a given time frame.

get/{store}/{app_id}/engagement/downloads

Path parameters

storestring required

Input either "Google" (Android) or "Apple" (iOS).

app_idstring required

Enter an app ID. How to find App IDs

Query parameters

api_keystring required

Your Similarweb API key.

start_datestring required

Start month (format: YYYY-MM)

end_monthstring required

End month (format: YYYY-MM)

countrystring required

Country filter, as a 2-letter ISO country code. To see the country filters you have access to, please refer to the Check Capabilities endpoint. For iOS apps, downloads are currently only available for the USA (“country=us”).

granularitystring required

Set the granularity for the returned values. Can be 'daily', 'weekly' or 'monthly'.

formatstring

[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'.

Response

200

Example response

{
  "meta": {
    "request": {
      "granularity": "Monthly",
      "start_date": "2017-11",
      "end_date": "2018-06",
      "store": "Google",
      "app_id": "com.whatsapp",
      "format": "json",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2019-08-31"
  },
  "downloads": [
    {
      "start_date": "2017-11-01",
      "end_date": "2017-11-30",
      "downloads": 4099107.5378811476
    }
  ]
}