post https://api.similarweb.com/v3/batch/apps/request-report
View key app usage, audience, and ranking metrics to evaluate app performance and benchmark your app's performance against competitors. This dataset is utilizing multiple tables.
Batch API and REST API have different Keys
Make sure you're using the correct API Key with the query
Example Request:
{
"apps":[
"com.nio.nioapp"
],
"countries": ["WW"],
"metrics":[
"apps_daily_active_users",
"apps_unique_installs",
"apps_downloads",
"apps_sessions_per_user",
"apps_avg_usage_time_per_session",
"apps_avg_total_usage_time_per_user"
],
"start_date": "2022-12-01",
"end_date": "2023-06-01",
"granularity": "daily",
"delivery_method": "download_link",
"response_format": "csv"
}
App Intelligence Table:
Table URL: https://api.similarweb.com/v3/batch/apps/request-report
Primary Keys: apps, country
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| apps_daily_active_users | Returns the number of Android devices that have used the app in the selected period of time. | Daily | Double |
| apps_monthly_active_users_standard_android, apps_monthly_active_users_standard_ios | Returns the number of devices that have used the app in the selected period of time | Monthly | Double |
| apps_unique_installs | Returns app unique installs from the store. | Monthly, Daily | Double |
| apps_downloads | Returns the app downloads from the store. | Monthly, Daily | Double |
| apps_sessions_per_user | Returns the average number of times each active user opened the app per day. | Monthly, Daily | Double |
| apps_avg_usage_time_per_session | Returns the average time spent in an app per user per day. | Monthly, Daily | Double |
| apps_avg_total_usage_time_per_user | Returns the average total time spent in an app per day. | Monthly, Daily | Double |
| apps_install_penetration | Returns the average percentage of devices in the defined market with the app installed. (Only available for Android) | Monthly, Daily | Double |
| apps_demographics_male_percentage, apps_demographics_female_percentage | Returns data on the app user demographics breakdown by gender. | Monthly | Double |
| apps_demographics_age_18_to_24_percentage, apps_demographics_age_25_to_34_percentage, apps_demographics_age_35_to_44_percentage, apps_demographics_age_45_to_54_percentage, apps_demographics_age_55_plus_percentage | Returns data on the app user demographics breakdown by age. | Monthly | Double |
| apps_retention_android | Measures the percentage of new Android users who are still active 30 days after their initial session, helping to assess user loyalty and the effectiveness of engagement strategies. | Monthly | Double |
| apps_ranking_history_android | Tracks the historical placement of an app in the Android app store’s rankings, allowing you to correlate changes in ranking with app updates, marketing efforts, or external events. | Daily | Double |
| apps_ranking_history_ios | Tracks the historical placement of an app in the iOS app store’s rankings, allowing you to correlate changes in ranking with app updates, marketing efforts, or external events. | Daily | Double |
Apps Premium (data.ai) Table:
Data Availability
This endpoint has been deprecated and will no longer receive new data. As a result, it currently returns data only until November 2023.
Table URL: https://api.similarweb.com/v3/batch/apps_premium/request-report
Primary Keys: apps, country
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| apps_data_ai_monthly_active_users_android, apps_data_ai_monthly_active_users_ios | Shows the number of unique Android and iOS users who opened an app at least once in a month, capturing the extent of user engagement on Android and iOS devices. | Monthly | Double |
| apps_data_ai_total_sessions_android, apps_data_ai_total_sessions_ios | Counts the total number of app sessions initiated by Android and iOS users within a month, reflecting the app’s usage frequency on Android and iOS devices. | Monthly | Double |
| apps_data_ai_total_time_android, apps_data_ai_total_time_ios | Calculates the cumulative time spent by all users in Android and iOS apps over a month, showcasing their total user engagement time. | Monthly | Double |
| apps_data_ai_average_monthly_user_sessions_android, apps_data_ai_average_monthly_user_sessions_ios | Averages the number of sessions per user on Android and iOS devices monthly, providing insights into how frequently users engage with an app. | Monthly | Double |
| apps_data_ai_average_session_length_android, apps_data_ai_average_session_length_ios | Averages the duration of each session in an app on Android and iOS devices, indicating how captivating and engaging the app is for users. | Monthly | Double |
| apps_data_ai_average_monthly_user_time_spent_android, apps_data_ai_average_monthly_user_time_spent_ios | Averages the total time each user spends in an app monthly, offering a comprehensive view of user engagement over time on Android and iOS. | Monthly | Double |
| apps_data_ai_install_base_android, apps_data_ai_install_base_ios | Provides the total number of Android and iOS devices that have an app installed, showing the app’s reach and popularity within the Android/iOS user base. | Monthly | Double |
| apps_data_ai_open_rate_android, apps_data_ai_open_rate_ios | Calculates the percentage of Android and iOS users who open an app after installing it, reflecting the app’s ability to retain user interest. | Monthly | Double |
| apps_data_ai_retention_day_30_android, apps_data_ai_retention_day_30_ios | Measures the percentage of new users who are still active 30 days after their initial session, offering insights into long-term user retention on Android and iOS. | Monthly | Double |
| apps_data_ai_affinity_android, apps_data_ai_affinity_ios | Measures the likelihood of an app's users also engaging with certain other apps on Android and iOS devices, helping to identify potential partnerships or competitive threats. | Monthly | Double |