Sign in

v1

latestOpenAPI 3.1.02026-07-24450694.7 KB

App Metrics - History

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

get/apps/metrics/history.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).

start_datestring date

Start date of the period in format YYYY-MM-DD<br/><b>Default:</b> 30 days ago

end_datestring date

End date of the period in format YYYY-MM-DD<br/><b>Default:</b> yesterday

countrystring

Two letter country code. You can only pass <b>one</b> country code. <br/><b>Default:</b> us

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

Choose a device from iphone, ipad or android. <br/><b>Default:</b> iphone

Response

200

OR

Example response

{
  "result": {
    "1521236603": {
      "downloads": [
        {
          "value": 886,
          "date": "2022-11-01",
          "precision": 1
        }
      ],
      "revenues": [
        {
          "value": 9228,
          "date": "2022-11-01",
          "precision": 1,
          "currency": "USD"
        }
      ],
      "ratings": [
        {
          "value": 4.791,
          "breakdown": {
            "1": 233,
            "2": 130,
            "3": 161,
            "4": 303,
            "5": 8475,
            "total": 9302,
            "avg": 4.791
          },
          "date": "2022-11-01"
        }
      ],
      "daily-ratings": [
        {
          "breakdown": {
            "3": 1,
            "5": 9
          },
          "date": "2022-11-01",
          "value": 4.8
        }
      ],
      "app-power": [
        {
          "value": 40.6,
          "date": "2022-11-01"
        }
      ]
    }
  },
  "metadata": {
    "request": {
      "path": "/api/public/store/apps/metrics/history.json",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "start_date": "2022-11-01",
        "end_date": "2022-11-03",
        "apps": [
          "1521236603"
        ],
        "metrics": [
          "downloads"
        ]
      },
      "cost": 1237,
      "max_credit_cost": 1237,
      "status": 200
    }
  }
}