Skip to main content

Export data from the search consoles with the Console Data API

Use AppTweak's console API to export data such as app downloads and revenues from App Store Connect or your Google Developer account.

Meghna Anand avatar
Written by Meghna Anand
Updated over 4 months ago

What is the Console Data API?

When you connect your App Store & Google Play Developer consoles you can use AppTweak's Console Data API (formerly Takeout API) to easily fetch your app's performance data from your integrations and visualize it in your favorite BI tool.

The API responses are all in JSON, including error messages and appropriate HTTP codes will be used to communicate success or failure. This API is read-only and it does not have methods to modify your account.

💡 AppTweak's Console Data API is used to fetch data related to your AppTweak account or your apps (including your apps' performance data fetched from the consoles via your AppTweak integration). AppTweak's App Store API can be used to fetch data such as keyword volumes or metadata updates of more than 3 million apps worldwide. For more information on the App Store API, check out this article.

Credits

The Console Data API is designed to allow you to fetch performance data of your apps and games. Since this is your data, AppTweak does not charge any credits to fetch this data.

Authentication

To get started you need to use the API token associated with your AppTweak account. This API token can be found in the 'API' tab.

Get data from your integrations

To be able to get the data related to your integrations, you first need to connect your App Store and Google Play accounts with AppTeak.

👉 Need more information on how to integrate your accounts with AppTweak? Check out this collection.

Documentation

In our documentation, you will find more information about how to get data from your App Store and Google Play integrations.

What integration data can I fetch?

App Store Connect Report

  • impressions Total Unique: The number of times your app was viewed on the App Store for more than one second. This includes search results, Featured, Explore, Top Charts, and app Product Page Views. Apps listed in Updates in the App Store app are not included.

  • page View Unique: The number of times your app’s App Store page has been viewed on a device using iOS 8 and tvOS 9 or later.

  • units: The number of first-time app purchases (which includes both paid and free apps) made on the App Store using iOS 8 and tvOS 9 or later. App updates, downloads from the same Apple ID onto other devices, and redownloads to the same device are not counted. Family Sharing downloads are included for free apps, but not for paid apps. Note: The Apple nomenclature changed from units to downloads. While we resolved this change internally, we are keeping the same naming (i.e. units).

  • redownloads: The number of redownloads on a device running iOS, tvOS, or macOS. Redownloads do not include auto-downloads, restores, or updates.

  • total-downloads: The number of first-time downloads and redownloads on devices with iOS, tvOS, or macOS.

  • iap: The number of first-time purchases of an In-App Purchase on a device using iOS 8 and tvOS 9 or later. Restored In-App Purchases, whether on the same or on a different device, are not counted.

  • sales: The total amount billed to customers for purchasing apps, app bundles, and in-app purchases. Sales are inclusive of any applicable taxes we collect and remit per Schedule 2 of the Paid Applications agreement.

  • paying Users: The number of paying users

  • installs: The total number of times your app has been installed on an iOS device with iOS 8 and tvOS 9 or later. Redownloads on the same device, downloads to multiple devices sharing the same Apple ID, and Family Sharing installations are included. Totals are based on app users who agree to share their data with you.

  • sessions: The number of times the app has been used for at least two seconds. If the app is in the background and is later used again, that counts as another session. Totals are based on app users who agree to share their data with you.

  • activeDevices: The number of active devices

  • rollingActiveDevices: The rolling number of active devices

👉 Read more about the data you can fetch with the App Store Connect – Report 

App Store Connect: Acquisition Channel Report

The integrations report endpoints provide the unique impressions, page views, and units by channel.

  • all

  • other (App Store Browse)

  • search (App Store Search)

  • appref (App Referrer)

  • webref (Web Referrer)

  • unknown (unavailable)

👉 Read more about the data you can fetch with the App Store Connect – Acquisition Channel Report

Google Play Reports: Statistics

The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak. units: The number of downloads.

  • uninstalls: The number of uninstalls.

  • sales: The sales of the country.

  • daily_devices: The list of 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 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.

  • 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.

  • new_subscriptions: The list of new subscriptions for all dates in the given date range.

  • total_new_subscriptions: The number of new subscriptions during all the date range.

  • active_subscriptions: The list of active subscriptions for all dates in the given date range.

  • total_active_subscriptions: The number of active subscriptions during all the date range.

  • cancelled_subscriptions: The list of cancelled subscriptions for all dates in the given date range.

  • total_cancelled_subscriptions: The number of cancelled subscriptions during all the date range.

  • new_subscriptions_growth: The average of new subscriptions during all the date range.

  • active_subscriptions_growth: The average of active subscriptions during all the date range.

  • cancelled_subscriptions_growth: The average of cancelled subscriptions during all the date range.

  • new_subscriptions_growth_variation: The variation between the new subscriptions growth for the selected date range and the previous equivalent date range.

  • active_subscriptions_growth_variation: The variation between the active subscriptions growth for the selected date range and the previous equivalent date range.

  • cancelled_subscriptions_growth_variation: The variation between the canceled subscriptions growth for the selected date range and the previous equivalent date range

👉 Read more about the data you can fetch with the Google Play Reports – Statistics

Google Play Console: Store Performance

With the Store Performance endpoint, you can fetch Store Listing Visitors & Store Listing Acquisitions data for your apps.

  • visitors: Array of integers: An array that give the number of visitors for each day in the period selected and for the given country

  • acquisition: Array of integers: An array that gives the number of acquisitions for each day in the period selected and for the given country

👉 Read more about the data you can fetch with the Google Play Console - Store Performance

Google Play Console: Install Keywords

With the Install Keywords endpoint, you can fetch all the keywords that drove organic traffic to any connected app over the selected date range. You will also get the breakdown of Store Listing Visitors & Store Listing Acquisitions per keyword.

  • visitors: Array of integers: An array that gives the number of visitors for each day in the period selected and for the given country

  • installs: Array of integers: An array that gives the number of installs for each day in the period selected and for the given country

👉 Read more about the data you can fetch with the Google Play Console - Install Keywords

How-to video

The following video showcases the different steps to make API calls in the Console Data API:

What's next?

Did this answer your question?