With the Bulk App Metrics endpoints in DataForSEO Labs API, you can get ranking metrics for up to 1000 mobile applications specified in a POST request.
Obtain app metrics for Google Play applications
1 Call the Google Play Bulk App Metrics endpoint.
POST https://api.dataforseo.com/v3/dataforseo_labs/google/bulk_app_metrics/live
2 Specify the IDs of the apps for which you would like to find ranking metrics in the app_ids field.
The app_id parameter can be found on the Google Play website as a part of a URL pointing to a specific mobile application. For example, here is the URL of the Telegram app on Google Play:
https://play.google.com/store/apps/details?id=org.telegram.messenger
The app_id of this app is org.telegram.messenger
Note that the maximum number of IDs you can specify in the app_ids field is 1000.
3 Specify the location parameters by adding the location_name or location_code field to the POST body.
Note that this endpoint currently supports the US location only.
4 Specify the language parameters by adding the language_name or language_code field to the POST body.
Note that this endpoint currently supports the English language only.
Your POST request should be structured as in the following example:
[
{
"app_ids": [
"org.telegram.messenger",
"com.zhiliaoapp.musically"
],
"location_code": 2840,
"language_code": "en"
}
]
Example of the API response:
{
"version": "0.1.20220627",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.2386 sec.",
"cost": 0.0102,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "07011242-2806-0453-0000-61ad8bddc91f",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1686 sec.",
"cost": 0.0102,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"google",
"bulk_app_metrics",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "bulk_app_metrics",
"se_type": "google",
"app_ids": [
"org.telegram.messenger",
"com.zhiliaoapp.musically"
],
"location_code": 2840,
"language_code": "en"
},
"result": [
{
"se_type": "google",
"location_code": 2840,
"language_code": "en",
"total_count": 2,
"items_count": 2,
"items": [
{
"se_type": "google",
"app_id": "com.zhiliaoapp.musically",
"metrics": {
"google_play_search_organic": {
"pos_1": 11243,
"pos_2_3": 3642,
"pos_4_10": 3990,
"pos_11_100": 6847,
"count": 25722,
"search_volume": 3716340
}
}
},
{
"se_type": "google",
"app_id": "org.telegram.messenger",
"metrics": {
"google_play_search_organic": {
"pos_1": 1347,
"pos_2_3": 548,
"pos_4_10": 2025,
"pos_11_100": 3721,
"count": 7641,
"search_volume": 1070807
}
}
}
]
}
]
}
]
}
Obtain app metrics for App Store applications
1 Call the App Store Bulk App Metrics endpoint.
POST https://api.dataforseo.com/v3/dataforseo_labs/apple/bulk_app_metrics/live
2 Specify the IDs of the apps for which you would like to find ranking metrics in the app_ids field.
The app_id parameter can be found on the App Store website as a part of a URL pointing to a specific mobile application. It consists of numbers indicated after id in the URL string. For example, here is the URL of the TikTok app on App Store:
https://apps.apple.com/us/app/id835599320
The app_id of this app is 835599320
Note that the maximum number of IDs you can specify in the app_ids field is 1000.
3 Specify the location parameters by adding the location_name or location_code field to the POST body.
Note that this endpoint currently supports the US location only.
4 Specify the language parameters by adding the language_name or language_code field to the POST body.
Note that this endpoint currently supports the English language only.
Your POST request should be structured as in the following example:
[
{
"app_ids": [
"686449807",
"382617920"
],
"location_code": 2840,
"language_name": "English"
}
]
Example of the API response:
{
"version": "0.1.20220627",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.3084 sec.",
"cost": 0.0102,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "07011257-2806-0453-0000-4b9ca16f3669",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1429 sec.",
"cost": 0.0102,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"apple",
"bulk_app_metrics",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "bulk_app_metrics",
"se_type": "apple",
"app_ids": [
"686449807",
"382617920"
],
"location_code": 2840,
"language_name": "English"
},
"result": [
{
"se_type": "apple",
"location_code": 2840,
"language_code": "en",
"total_count": 2,
"items_count": 2,
"items": [
{
"se_type": "apple",
"app_id": "382617920",
"metrics": {
"app_store_search_organic": {
"pos_1": 213,
"pos_2_3": 317,
"pos_4_10": 1309,
"pos_11_100": 3505,
"count": 5344,
"search_volume": 42237121
}
}
},
{
"se_type": "apple",
"app_id": "686449807",
"metrics": {
"app_store_search_organic": {
"pos_1": 214,
"pos_2_3": 167,
"pos_4_10": 570,
"pos_11_100": 1855,
"count": 2806,
"search_volume": 34508416
}
}
}
]
}
]
}
]
}