v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

App Install Penetration

Returns the percentage of the devices in a defined market with the app installed.

get/{store}/{app_id}/engagement/current-installs

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_datestring 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.

granularitystring

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": "2018-01",
      "end_date": "2018-06",
      "store": "Google",
      "app_id": "com.whatsapp",
      "format": "json",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2019-02-28"
  },
  "current_installs": [
    {
      "start_date": "2018-01-01",
      "end_date": "2018-01-31",
      "installs": 0.2317956991112151
    }
  ]
}