post https://api.similarweb.com/batch/v4/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:
{
"delivery_information": {
"response_format": "csv",
"delivery_method_params": {
"retention_days": 60
}
},
"report_query": {
"tables": [
{
"vtable": "apps",
"granularity": "monthly",
"filters": {
"apps": [
"com.facebook.katana",
"284882215"
],
"countries": [
"WW",
"US"
]
},
"metrics": [
"apps_avg_total_usage_time_per_user",
"apps_avg_usage_time_per_session",
"apps_daily_active_users_android",
"apps_daily_active_users_ios",
"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",
"apps_demographics_female_percentage",
"apps_demographics_male_percentage",
"apps_downloads",
"apps_install_penetration",
"apps_monthly_active_users_android",
"apps_monthly_active_users_ios",
"apps_monthly_active_users_standard_android",
"apps_monthly_active_users_standard_ios",
"apps_sessions_per_user",
"apps_unique_installs"
],
"start_date": "2024-06",
"end_date": "2024-06"
}
]
}
}
App Intelligence Table:
vtable: "apps"
Table URL: https://api.similarweb.com/batch/v4/request-report
Primary Keys: apps, country
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| apps_daily_active_users_andriod | 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 |
Web-App Cross Usage:
https://api.similarweb.com/batch/v4/request-report
vtable: "web_app_cross_use"
Primary Keys: apps, country
| Metric Name | Description | Supported Granularity | Type |
|---|---|---|---|
| app_web_affinity | Returns for each app the value by which the app’s users are X time more likely to visit a website, compared to the general population | Monthly | Double |
| app_web_cross_usage | Returns for each app, the probability that an app’s users have visited a website | Monthly | Double |