Apps Dataset
The Batch API Apps Dataset provides comprehensive app intelligence across iOS and Android platforms, enabling you to analyze app performance, user behavior, competitive positioning, and technology adoption. Access detailed metrics on downloads, user engagement, demographics, retention, rankings, and cross-platform usage patterns.
Historical Data Availability
Access up to 37 months of historical data, depending on your subscription plan
What you can track
- App Performance: Monthly active users, downloads, session data, and engagement metrics
- User Demographics: Age and gender breakdowns for app audiences
- Technology Stack: SDKs and third-party integrations within apps
- User Retention: 30-day retention rates for Android apps
- App Store Rankings: Historical placement data for both iOS and Android
- App Affinity: User overlap between apps for partnership and competitive analysis
Batch API and REST API have different Keys
Make sure you're using the correct API Key to perform this query
Need Help Finding App IDs?
Learn how to locate Android package names and iOS App Store IDs in our detailed guide: How to Find App IDs
Getting Started
1. Authentication
Include your Batch API key in the request headers:
curl -X POST \
https://api.similarweb.com/batch/v4/request-report \
-H 'Content-Type: application/json' \
-H 'api-key: YOUR_BATCH_API_KEY'
2. Request Structure
All Batch API requests follow this structure:
Available Tables (vtables)
App Intelligence (apps)
apps)Primary use case: Core app performance metrics, user engagement, and demographics
Primary Keys: apps, country
Available Metrics:
| Metric Name | Description | Granularity | Type |
|---|---|---|---|
application_name | App name | Monthly, Daily | String |
apps_mau_ios, apps_mau_android | Monthly active users by platform | Monthly | Double |
apps_downloads_ios, apps_downloads_android | App store downloads by platform | Monthly, Daily | Double |
apps_install_penetration | Percentage of devices with app installed (Android only) | Monthly, Daily | Double |
apps_total_sessions_ios, apps_total_sessions_android | Total daily app usage time | Monthly, Daily | Double |
apps_avg_sessions_time_ios, apps_avg_sessions_time_android | Average session duration per user per day | Monthly, Daily | Double |
apps_avg_num_of_sessions_ios, apps_avg_num_of_sessions_android | Average daily sessions per active user | Monthly, Daily | Double |
apps_demographics_male_percentage, apps_demographics_female_percentage | Gender distribution of app users | 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 | Age distribution of app users | Monthly | Double |
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": [
"application_name",
"apps_mau_ios",
"apps_mau_android",
"apps_downloads_ios",
"apps_downloads_android",
"apps_install_penetration",
"apps_total_sessions_ios",
"apps_total_sessions_android",
"apps_avg_sessions_time_ios",
"apps_avg_sessions_time_android",
"apps_avg_num_of_sessions_ios",
"apps_avg_num_of_sessions_android",
"apps_demographics_male_percentage",
"apps_demographics_female_percentage",
"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"
],
"start_date": "2025-03",
"end_date": "2025-06"
}
]
}
}
App Technographics (apps_technographics)
apps_technographics)Primary use case: Technology stack analysis and SDK adoption tracking
Primary Keys: apps
Available Metrics:
| Metric Name | Description | Granularity |
|---|---|---|
device_type | Platform where SDK detected: 'google' or 'apple' | Daily |
sdk_name | Name of the detected SDK | Daily |
sdk_description | Detailed explanation of SDK functionality | Daily |
sdk_category | Technology classification and specialized area | Daily |
sdk_status | Integration status: 'installed' or 'not installed' | Daily |
Example Request:
{
"delivery_information": {
"response_format": "csv",
"delivery_method_params": {
"retention_days": 60
}
},
"report_query": {
"tables": [
{
"vtable": "apps_technographics",
"granularity": "daily",
"filters": {
"apps": [
"com.facebook.katana",
"297606951"
]
},
"metrics": [
"device_type",
"sdk_category",
"sdk_description",
"sdk_name",
"sdk_status"
],
"start_date": "2025-05-08",
"end_date": "2025-05-08"
}
]
}
}
App Retention (apps_retention)
apps_retention)Primary use case: User retention analysis and app stickiness measurement
Primary Keys: apps
Available Metrics:
| Metric Name | Description | Granularity |
|---|---|---|
apps_retention_android | The percentage of users who used the app 30 days after opening it for the first time | Monthly |
Example Request:
{
"delivery_information": {
"response_format": "csv",
"delivery_method_params": {
"retention_days": 60
}
},
"report_query": {
"tables": [
{
"vtable": "apps_retention",
"granularity": "monthly",
"filters": {
"apps": [
"com.facebook.katana"
],
"countries": [
"WW"
]
},
"metrics": [
"apps_retention_android"
],
"start_date": "2025-07",
"end_date": "2025-07"
}
]
}
}
App Ranking History (apps_ranking_history)
apps_ranking_history)Primary use case: App store performance tracking and competitive ranking analysis
Primary Keys: apps
Available Metrics:
| Metric Name | Description | Granularity |
|---|---|---|
apps_ranking_history_android | Historical Google Play Store ranking position | Daily |
apps_ranking_history_ios | Historical Apple App Store ranking position | Daily |
Example Request:
{
"delivery_information": {
"response_format": "csv",
"delivery_method_params": {
"retention_days": 60
}
},
"report_query": {
"tables": [
{
"vtable": "apps_ranking_history",
"granularity": "daily",
"filters": {
"apps": [
"com.facebook.katana"
],
"countries": [
"WW"
],
"modes": [
"topselling_free",
"topgrossing",
"topselling_paid",
"topselling_new_free",
"topselling_new_paid"
],
"device_types": [
"android-phone",
"android-tablet",
"ios-phone",
"ios-tablet"
]
},
"metrics": [
"apps_ranking_history_android",
"apps_ranking_history_ios"
],
"start_date": "2025-08-04",
"end_date": "2025-08-04"
}
]
}
}
Apps Affinity (apps_affinity)
apps_affinity)Primary use case: Identify apps with overlapping user bases for partnership opportunities or competitive threats (Android only).
Primary Keys: apps, country
Available Metrics:
| Metric Name | Description | Granularity | Type |
|---|---|---|---|
apps_affinity_android | Returns apps with overlapping user bases | Monthly | Double |
Example Request:
{
"delivery_information": {
"response_format": "csv",
"delivery_method_params": {
"retention_days": 60
}
},
"report_query": {
"tables": [
{
"vtable": "apps_affinity",
"granularity": "monthly",
"filters": {
"apps": [
"com.facebook.katana"
],
"countries": [
"US"
]
},
"metrics": [
"apps_affinity_android"
],
"start_date": "2025-07",
"end_date": "2025-07"
}
]
}
}
Updated about 3 hours ago