How do I get SERP data from Google Play and App Store? – DataForSEO
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 and Apple App Searches endpoints of App Data API, 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
- Call the Google App Searches Task POST endpoint.
POST https://api.dataforseo.com/v3/app_data/google/app_searches/task_post
- Specify the keyword for which you wish to receive an app list.
Example "keyword": "vpn"
- Specify the location parameters by adding the
location_nameorlocation_codefield to the POST body.
You will receive the full list of available locations by making a separate request to the Locations endpoint.
GET https://api.dataforseo.com/v3/app_data/google/locations
- Specify the language parameters by adding the
language_nameorlanguage_codefield to the POST body.
You will receive the full list of available languages by making a separate request to the Languages endpoint.
GET https://api.dataforseo.com/v3/app_data/google/languages
Specify the number of apps to be returned in the API response. To do so, add the
depthparameter 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
depthas101you will be charged for 200 results.Default
depthvalue: 100.
Maximum depth value: 200.
Your POST request should be structured as in the following example:
[ { "keyword": "vpn", "location_code": 2840, "language_code": "en" } ]
- Send your request and use the Task ID from the response to retrieve the results from the 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
- Call the Apple App Searches Task POST endpoint.
POST https://api.dataforseo.com/v3/app_data/apple/app_searches/task_post
- Specify the keyword for which you wish to receive an app list.
Example "keyword": "vpn"
- Specify the location parameters by adding the
location_nameorlocation_codefield to the POST body.
You will receive the full list of available locations by making a separate request to the Locations endpoint.
GET https://api.dataforseo.com/v3/app_data/apple/locations
- Specify the language parameters by adding the
language_nameorlanguage_codefield to the POST body.
You will receive the full list of available languages by making a separate request to the Languages endpoint.
GET https://api.dataforseo.com/v3/app_data/apple/languages
Specify the number of apps to be returned in the API response. To do so, add the
depthparameter 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
depthas101you will be charged for 200 results.Default
depthvalue: 100.
Maximum depth value: 1000.
Your POST request should be structured as in the following example:
[ { "keyword": "vpn", "location_code": 2840, "language_code": "en" } ]
- Send your request and use the Task ID from the response to retrieve the results from the 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: