App Power

GET 3 Credits / Request / 30 days /ios/applications/{APPLICATION_ID}/power.json

The App Power indicates the power of the app based on its rankings in its category and in the overall category.

The App Power Request

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Path parameters
APPLICATION_ID:
Application ID for which you want to get the metadata.
Query parameters
country: string us

The two letter country code (ISO Alpha-2) you want to fetch the app in.

us. Get the list of our country codes, here.

device: string iphone

The device you want to fetch the application for.

iphone or ipad

start_date: date

Start date, format: YYYY-MM-DD

end_date: date

End date, format: YYYY-MM-DD

GET /ios/applications/{APPLICATION_ID}/power.json

Request example
GET /ios/applications/686449807/power.json?country=us&start_date=2018-10-03&end_date=2018-10-10&device=iphone
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/ios/applications/686449807/power.json?country=us&start_date=2018-10-03&end_date=2018-10-10&device=iphone

App Power Response

The response for the App Power request is a JSON hash containing all the calculated values for the given application in the selected country and period (dates range) on the App Store.

Object properties
country_code (e.g. us): array

Key/value pairs containing the history of the App Power on the selected period per device.

CHILD PROPERTIES

device: array

The list of devices the app is available on. Can contain : ipad, ipod and iphone.

start_date: datetime

Start date for the selected period.

end_date: datetime

End date for the selected period.

power: hash

Key/number pairs listing all calculated App Power for each day on the selected period.

Response Example

{
  "content": {
    "us": [
      {
        "start_date": "2018-10-03",
        "end_date": "2018-10-10",
        "device": "iphone",
        "power": [
          100.0,
          100.0,
          100.0,
          100.0,
          100.0,
          100.0,
          100.0,
          100.0
        ]
      },
      {
        "start_date": "2018-10-03",
        "end_date": "2018-10-10",
        "device": "ipad",
        "power": [
          100.0,
          100.0,
          100.0,
          100.0,
          100.0,
          100.0,
          100.0,
          100.0
        ]
      }
    ]
  },
  "metadata": {
    "request": {
      "path": "/applications/284882215/power.json",
      "store": "ios",
      "params": {
        "country": "us",
        "start_date": "2018-10-03T00:00:00+00:00",
        "end_date": "2018-10-10T00:00:00+00:00",
        "id": "284882215",
        "format": "json"
      },
      "performed_at": "2018-11-20 16:03:56 UTC"
    },
    "content": {
    }
  }
}