The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak.
The Google Play Reports Statistics endpoint allows you to fetch different reports related to your Google Play Reports integrations in AppTweak.
Available history
We fetch all the available CSVs. In other words, we fetch all the available historical data.
Update frequency
We're fetching the data on a daily basis.
Delay in the Data
You may notice a couple of days' delay between today and the last registered data point. Google never provides the data until today, there is usually a 3-day difference between the last available data in the console and today. This delay can sometimes be longer.
Input parameters
The following table lists the property parameters to access different type of data from your Google Play Report integration
| path parameter property | returned metrics |
|---|---|
| units | The number of new users installs and the number of new device installs. |
| uninstalls | The number of users who uninstalled your app from all of their devices. |
| sales | The number of app sales, in-app product sales, or subscription sales. |
| subscriptions | The number of new subscriptions, active subscriptions and cancelled subscriptions. |
Response format
Each property will return one or multiple metrics from the Google Play Reports.
units
The units property will return the following fields in the response
| response field | description |
|---|---|
| daily_devices | The list of new daily device installs for the given date range. |
| total_devices | The total amount of device installs for the given date range. |
| daily_users | The list of new daily user installs for the given date range. |
| total_users | The total amount of user installs for the given date range. |
| devices_growth | The average of daily device installs for the given date range. |
| users_growth | The average of daily user installs for the given date range. |
| devices_growth_variation | The variation between the daily device installs growth for the selected date range and the previous equivalent date range. |
| users_growth_variation | The variation between the daily user installs growth for the selected date range and the previous equivalent date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"fr": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"daily_devices": [ // List of daily new device installs
23, // The first entry corresponds to the start_date
13
],
"total_devices": 36, // Sum of all the new device installs over the daterange
"daily_users": [ // List of daily new user installs
20, // The first entry corresponds to the start_date
7
],
"total_users": 27, // Sum of all the new users installs over the datarange
"devices_growth": 18,
"users_growth": 13.5,
"devices_growth_variation": -5.5,
"users_growth_variation": -5.5
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "units",
"apps": null,
"countries": [
"fr"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}uninstalls
The uninstalls property will return the following fields in the response
| response field | description |
|---|---|
| daily_users_uninstalls | The list of daily user uninstalls for the given date range. |
| total_users_uninstalls | The total amount of user uninstalls for the given date range. |
| users_uninstalls_growth | The average of daily user uninstalls for the given date range. |
| users_uninstalls_growth_variation | The variation between the daily user uninstalls growth for the selected date range and the previous equivalent date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"fr": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"daily_users_uninstalls": [
12,
4
],
"total_users_uninstalls": 16,
"users_uninstalls_growth": 8,
"users_uninstalls_growth_variation": -3.5
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "uninstalls",
"apps": null,
"countries": [
"fr"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}sales
To get the sales for Android apps, we fetch the data coming from Financial Reports > Earnings Report from your Google Play Console, we convert all earnings to USD and then we sum all your earnings to compute your app's total revenue.
The sales property will return the following fields in the response
| response field | description |
|---|---|
| values | List of values of the daily revenues for the given date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"uy": {
"start_date": "2022-11-14",
"end_date": "2022-11-15",
"values": [
72.72,
110.25
]
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-11-14",
"end_date": "2022-11-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "sales",
"apps": null,
"countries": [
"us"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}subscriptions
You can find object properties of the request response in the following table:
| response field | type | description |
|---|---|---|
| new_subscriptions | integer array | The list of new subscriptions for all dates in the given date range. |
| total_new_subscriptions | integer | The amount of new subscriptions during all the date range. |
| active_subscriptions | integer array | The list of active subscriptions for all dates in the given date range. |
| total_active_subscriptions | integer | The amount of active subscriptions during all the date range. |
| cancelled_subscriptions | integer array | The list of cancelled subscriptions for all dates in the given date range. |
| total_cancelled_subscriptions | integer | The amount of cancelled subscriptions during all the date range. |
| new_subscriptions_growth | double | The average of new subscriptions during all the date range. |
| active_subscriptions_growth | double | The average of active subscriptions during all the date range. |
| cancelled_subscriptions_growth | double | The average of cancelled subscriptions during all the date range. |
| new_subscriptions_growth_variation | double | The variation between the new subscriptions growth for the selected date range and the previous equivalent date range. |
| active_subscriptions_growth_variation | double | The variation between the active subscriptions growth for the selected date range and the previous equivalent date range |
| double | The variation between the cancelled subscriptions growth for the selected date range and the previous equivalent date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"dk": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"new_subscriptions": [
232,
320
],
"total_new_subscriptions": 552,
"active_subscriptions": [
2107,
909
],
"total_active_subscriptions": 3096,
"cancelled_subscriptions": [
339,
151
],
"total_cancelled_subscriptions": 490,
"new_subscriptions_growth": 276,
"active_subscriptions_growth": 1548,
"cancelled_subscriptions_growth": 245,
"new_subscriptions_growth_variation": 499,
"active_subscriptions_growth_variation": 356,
"cancelled_subscriptions_growth_variation": 245
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "subscriptions",
"apps": null,
"countries": [
"dk"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}FAQs
How do I fetch new installs and uninstalls for an Android app via API?
You can pull new installs with the units property and uninstalls with the uninstalls property on AppTweak's Google Play Reports - Statistics endpoint (GET /accounts/reports). The units property returns daily_devices and daily_users arrays plus their date-range totals and growth figures; the uninstalls property returns the equivalent daily_users_uninstalls array, total_users_uninstalls, and growth variation. Each call takes one property at a time, so installs and uninstalls need separate requests.
How do I retrieve Android app revenue from Google Play financial reports via API?
You can pull daily revenue with the sales property on the Google Play Reports - Statistics endpoint. The response returns a values array of daily revenue figures, one entry per date in the requested range, converted to USD and summed from app sales, in-app purchase sales, and subscription sales as reported in the Google Play Console's Financial Reports. countries is required for this endpoint, so a call must specify at least one country to fetch revenue for.
How do I track new, active, and cancelled subscriptions for an Android app via API?
You can fetch all three subscription states in one call with the subscriptions property on the Google Play Reports - Statistics endpoint. The response returns new_subscriptions, active_subscriptions, and cancelled_subscriptions as daily arrays, each with a corresponding total_* sum across the date range and a *_growth/*_growth_variation figure comparing the average daily rate to the previous equivalent period.
What parameters does the Google Play Reports endpoint require?
The Google Play Reports - Statistics endpoint requires three parameters: id, property, and countries. id is the integrated google-play-reports account, property is one of units, uninstalls, sales, or subscriptions, and countries is a comma-separated list of two-letter country codes with no default. Optional parameters are apps (defaults to all connected apps), start_date (defaults to 30 days ago), and end_date (defaults to yesterday); devices is fixed to android for this endpoint.
Who can access Google Play financial and subscription reports through the API?
Google Play Reports data is available only on AppTweak's Unlimited API plans, not on the low-touch Small, Medium, or Large tiers. This covers installs, uninstalls, sales, and subscriptions alike, since all four are properties of the same endpoint. Within Unlimited, the Unlimited Analytics API (tied to an ASO Enterprise subscription) covers reporting and monitoring use cases; building software on this data, or reselling it, requires the separate, higher-tier regular Unlimited API.