v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

App Metrics - Current

Get the most recent metrics of an app (downloads, revenues, ratings & app power).

get/apps/metrics/current.json

Query parameters

appsstring required

Comma separated list of app IDs. Max 5 apps are allowed. <br/> <a href="https://developers.apptweak.com/reference/how-to-find-app-ids" target="_blank">How to find App IDs?</a>

metricsstring required

Comma separated list of metrics. Available metrics are listed in the table above (e.g. downloads,ratings)

countrystring

Two letter <a href="https://apptweak.readme.io/reference/country-codes">country code</a>. <br/><b>Default:</b> us

device'iphone' | 'ipad' | 'android'

The device you want to fetch the top chart for: iphone, ipad or android. <br/><b>Default:</b> iphone

Response

200

OR

Example response

{
  "result": {
    "1064216828": {
      "downloads": {
        "value": 5930,
        "date": "2022-12-04",
        "precision": 1
      },
      "revenues": {
        "value": 13029,
        "date": "2022-12-04",
        "precision": 1,
        "currency": "USD"
      },
      "app-power": {
        "value": 99.5,
        "date": "2022-12-04"
      },
      "ratings": {
        "value": 4.821,
        "breakdown": {
          "1": 38053,
          "2": 8580,
          "3": 33697,
          "4": 201739,
          "5": 2219864,
          "total": 2501933,
          "avg": 4.821
        },
        "date": "2022-12-04"
      },
      "daily-ratings": {
        "breakdown": {
          "1": 31,
          "2": 6,
          "3": 15,
          "4": 53,
          "5": 530
        },
        "date": "2022-12-04",
        "value": 4.645669291338582
      }
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/metrics/current.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "apps": [
          "1064216828"
        ],
        "metrics": [
          "downloads"
        ]
      },
      "cost": 1031,
      "max_credit_cost": 1031,
      "status": 200
    }
  }
}