# How do I get SERP data from Google Play and App Store?

Google Play and App Store have search engines allowing users to search for mobile applications with keywords.

Using the [Google App Searches](https://docs.dataforseo.com/v3/app_data/google/app_searches/task_post/) and [Apple App Searches](https://docs.dataforseo.com/v3/app_data/apple/app_searches/task_post/) endpoints of [App Data API,](https://docs.dataforseo.com/v3/app_data/overview/) you can access SERP data from both platforms. These endpoints will provide ranking data for each application along with additional app information: its ID, icon, reviews count, rating, price, and other data.

#### Collecting SERPs from Google Play

1. Call the Google App Searches Task POST endpoint.

`POST https://api.dataforseo.com/v3/app_data/google/app_searches/task_post`

2. Specify the keyword for which you wish to receive an app list.

Example `"keyword": "vpn"`

3. Specify the location parameters by adding the `location_name` or `location_code` field to the POST body.

You will receive the full list of available locations by making a separate request to the [Locations endpoint.](https://docs.dataforseo.com/v3/app_data/google/locations/?bash)
   
   `GET https://api.dataforseo.com/v3/app_data/google/locations`

4. Specify the language parameters by adding the `language_name` or `language_code` field to the POST body.

You will receive the full list of available languages by making a separate request to the [Languages endpoint.](https://docs.dataforseo.com/v3/app_data/google/languages)

`GET https://api.dataforseo.com/v3/app_data/google/languages`

5. Specify the number of apps to be returned in the API response. To do so, add the `depth` parameter and set it to the desired value.
   
   **We strongly recommend** setting the parsing depth in the multiples of 100 as our system processes 100 results in a row. Thus, if you specify `depth` as `101` you will be charged for 200 results.
 
   Default `depth` value: 100.

Maximum `depth` value: 200.

Your POST request should be structured as in the following example:

`[
       {  
           "keyword": "vpn",
           "location_code": 2840,
           "language_code": "en"
       }
   ]`

6. Send your request and use the Task ID from the response to retrieve the results from the [Google App Searches Task GET Advanced](https://docs.dataforseo.com/v3/app_data/google/app_searches/task_get/advanced/) endpoint.

`GET https://api.dataforseo.com/v3/app_data/google/app_searches/task_get/advanced/$id`

### Example of the API response:

```  
   {  
       "version": "0.1.20220428",
       "status_code": 20000,
       "status_message": "Ok.",
       "time": "0.0819 sec.",
       "cost": 0,
       "tasks_count": 1,
       "tasks_error": 0,
       "tasks": [
           {
               "id": "05161130-2806-0428-0000-7c28f324e6f7",
               "status_code": 20000,
               "status_message": "Ok.",
               "time": "0.0292 sec.",
               "cost": 0,
               "result_count": 1,
               "path": [
                   "v3",
                   "app_data",
                   "google",
                   "app_searches",
                   "task_get",
                   "advanced",
                   "05161130-2806-0428-0000-7c28f324e6f7"
               ],
               "data": {
                   "se_type": "organic",
                   "se": "google",
                   "api": "app_data",
                   "function": "app_searches",
                   "keyword": "vpn",
                   "location_code": 2840,
                   "language_code": "en",
                   "device": "desktop",
                   "os": "windows"
               },
               "result": [
                   {
                       "keyword": "vpn",
                       "se_domain": "play.google.com",
                       "location_code": 2840,
                       "language_code": "en",
                       "check_url": "https://play.google.com/store/search?c=apps&q=vpn&hl=en&gl=us&price=0",
                       "datetime": "2022-05-16 08:30:26 +00:00",
                       "se_results_count": 0,
                       "items_count": 100,
                       "items": [
                           {
                               "type": "google_play_search_organic",
                               "rank_group": 1,
                               "rank_absolute": 1,
                               "position": "left",
                               "app_id": "free.vpn.unblock.proxy.turbovpn",
                               "title": "Turbo VPN - Secure VPN Proxy",
                               "url": "https://play.google.com/store/apps/details?id=free.vpn.unblock.proxy.turbovpn",
                               "icon": "https://play-lh.googleusercontent.com/G7AkY7FY1XZQU8Xp_h5OGGovDxySJ2tLSlPxNRfl9E3lKDzyqY-2QYByz3CHovWRcg",
                               "reviews_count": null,
                               "rating": {
                                   "rating_type": "Max5",
                                   "value": 4.659049,
                                   "votes_count": null,
                                   "rating_max": 5
                               },
                               "is_free": true,
                               "price": {
                                   "current": 0,
                                   "regular": null,
                                   "max_value": null,
                                   "currency": null,
                                   "is_price_range": false,
                                   "displayed_price": null
                               },
                               "developer": "Innovative Connecting",
                               "developer_url": "https://play.google.com/store/apps/developer?id=Innovative+Connecting"
                           },
                           {
                               "type": "google_play_search_organic",
                               "rank_group": 2,
                               "rank_absolute": 2,
                               "position": "left",
                               "app_id": "free.vpn.unblock.proxy.turbovpn.lite",
                               "title": "Turbo VPN Lite - VPN Proxy",
                               "url": "https://play.google.com/store/apps/details?id=free.vpn.unblock.proxy.turbovpn.lite",
                               "icon": "https://play-lh.googleusercontent.com/K7Dt5JJVovywDkii68EEcxY6TEHlyRWUQ75xPrbx1e1-wKJR41CwiPVAcHa0E-0GgIE",
                               "reviews_count": null,
                               "rating": {
                                   "rating_type": "Max5",
                                   "value": 4.640302,
                                   "votes_count": null,
                                   "rating_max": 5
                               },
                               "is_free": true,
                               "price": {
                                   "current": 0,
                                   "regular": null,
                                   "max_value": null,
                                   "currency": null,
                                   "is_price_range": false,
                                   "displayed_price": null
                               },
                               "developer": "Innovative Connecting",
                               "developer_url": "https://play.google.com/store/apps/developer?id=Innovative+Connecting"
                           }
                           // Additional app items omitted for brevity
                       ]
                   }
               ]
           }
       ]
   }  
   ```

#### Collecting app lists from App Store

1. Call the Apple App Searches Task POST endpoint.

`POST https://api.dataforseo.com/v3/app_data/apple/app_searches/task_post`

2. Specify the keyword for which you wish to receive an app list.

Example `"keyword": "vpn"`

3. Specify the location parameters by adding the `location_name` or `location_code` field to the POST body.

You will receive the full list of available locations by making a separate request to the [Locations endpoint.](https://docs.dataforseo.com/v3/app_data/apple/locations/?bash)
   
   `GET https://api.dataforseo.com/v3/app_data/apple/locations`

4. Specify the language parameters by adding the `language_name` or `language_code` field to the POST body.

You will receive the full list of available languages by making a separate request to the [Languages endpoint.](https://docs.dataforseo.com/v3/app_data/apple/languages/?bash)

`GET https://api.dataforseo.com/v3/app_data/apple/languages`

5. Specify the number of apps to be returned in the API response. To do so, add the `depth` parameter and set it to the desired value.
   
   **We strongly recommend** setting the parsing depth in the multiples of 100 as our system processes 100 reviews in a row. Thus, if you specify `depth` as `101` you will be charged for 200 results.
 
   Default `depth` value: 100.

Maximum `depth` value: 1000.

Your POST request should be structured as in the following example:

`[
       {  
           "keyword": "vpn",
           "location_code": 2840,
           "language_code": "en"
       }
   ]`

6. Send your request and use the Task ID from the response to retrieve the results from the [Apple App Searches Task GET Advanced](https://docs.dataforseo.com/v3/app_data/apple/app_searches/task_get/advanced/) endpoint.

`GET https://api.dataforseo.com/v3/app_data/apple/app_searches/task_get/advanced/$id`

### Example of the API response:

```  
   {  
       "version": "0.1.20220428",
       "status_code": 20000,
       "status_message": "Ok.",
       "time": "0.0755 sec.",
       "cost": 0,
       "tasks_count": 1,
       "tasks_error": 0,
       "tasks": [
           {
               "id": "05161133-2806-0428-0000-168da2be5a44",
               "status_code": 20000,
               "status_message": "Ok.",
               "time": "0.0249 sec.",
               "cost": 0,
               "result_count": 1,
               "path": [
                   "v3",
                   "app_data",
                   "apple",
                   "app_searches",
                   "task_get",
                   "advanced",
                   "05161133-2806-0428-0000-168da2be5a44"
               ],
               "data": {
                   "se_type": "organic",
                   "se": "apple",
                   "api": "app_data",
                   "function": "app_searches",
                   "keyword": "vpn",
                   "location_code": 2840,
                   "language_code": "en",
                   "device": "desktop",
                   "os": "windows"
               },
               "result": [
                   {
                       "keyword": "vpn",
                       "se_domain": "itunes.apple.com",
                       "location_code": 2840,
                       "language_code": "en",
                       "check_url": null,
                       "datetime": "2022-05-16 08:33:23 +00:00",
                       "se_results_count": 270,
                       "items_count": 99,
                       "items": [
                           {
                               "type": "app_store_search_organic",
                               "rank_group": 1,
                               "rank_absolute": 1,
                               "position": "left",
                               "app_id": "1370293473",
                               "title": "VPN - Super Unlimited Proxy",
                               "url": "https://apps.apple.com/us/app/vpn-super-unlimited-proxy/id1370293473",
                               "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple112/v4/9a/dc/01/9adc014f-df1b-5ff9-1149-bacae883da6d/AppIcon-1x_U007emarketing-0-10-0-sRGB-85-220.png/512x512bb.jpg",
                               "reviews_count": 1359197,
                               "rating": {
                                   "rating_type": "Max5",
                                   "value": 4.63237,
                                   "votes_count": 1359197,
                                   "rating_max": 5
                               },
                               "is_free": true,
                               "price": {
                                   "current": 0,
                                   "regular": null,
                                   "max_value": null,
                                   "currency": "USD",
                                   "is_price_range": false,
                                   "displayed_price": null
                               }
                           },
                           // Additional app items omitted for brevity
                       ]
                   }
               ]
           }
       ]
   }  
   ```

## Embed DataForSeo widget on your website

Width:

Height:

Embed code:

Copy Code

Preview:
