v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

App Rank

Returns the iOS app rank from the Apple App Store and the Android app rank from Google Play for a certain app.

get/{store}/{app_id}/rank/app-store-rank

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.

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.

categorystring required

modestring required

Values can be found in the App Rank Describe endpoint: https://api.similarweb.com/v1/app/rank/describe (no parameters required).

devicestring required

Possible values: "androidphone" for Android apps, "iphone" or "ipad" for iOS apps.

durationstring required

Number of days back from the present date you would like to receive rank data.

formatstring

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

Response

200

Example response

{
  "meta": {
    "request": {
      "country": "us",
      "format": "json",
      "store": "Google",
      "app_id": "com.whatsapp",
      "mode": "free",
      "category": "all",
      "device": "android-phone",
      "duration": 30
    },
    "status": "Success",
    "last_updated": "2022-11-02"
  },
  "ranks": [
    {
      "date": "2022-10-03",
      "value": 3
    }
  ]
}