HELP CENTER

How to get ranking metrics for multiple apps?

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
                                }
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Embed DataForSeo widget on your website


Embed code:
Preview: