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
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.
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.
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 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"
},
{
"type": "google_play_search_organic",
"rank_group": 3,
"rank_absolute": 3,
"position": "left",
"app_id": "com.fast.free.unblock.secure.vpn",
"title": "Secure VPN－Safer Internet",
"url": "https://play.google.com/store/apps/details?id=com.fast.free.unblock.secure.vpn",
"icon": "https://play-lh.googleusercontent.com/jGWTmzRGONph6Z8Df6JRuTVbBrL8-k-Tdx6CDzJblf5Rcxr914wZxrdCn6G2Jta0kks",
"reviews_count": null,
"rating": {
"rating_type": "Max5",
"value": 4.716901,
"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": "Signal Lab",
"developer_url": "https://play.google.com/store/apps/dev?id=6481577571535301345"
},
{
"type": "google_play_search_organic",
"rank_group": 4,
"rank_absolute": 4,
"position": "left",
"app_id": "free.vpn.unblock.proxy.vpn.master.pro",
"title": "VPN Proxy Master - Safer Vpn",
"url": "https://play.google.com/store/apps/details?id=free.vpn.unblock.proxy.vpn.master.pro",
"icon": "https://play-lh.googleusercontent.com/Mf5aPVgpFRga4CL9ySdAEK-bnSsBoxSTpg7NpJveH9yagrk-2yS3jR7YKuJwM10myg",
"reviews_count": null,
"rating": {
"rating_type": "Max5",
"value": 4.691163,
"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": "LEMON CLOVE PTE. LIMITED",
"developer_url": "https://play.google.com/store/apps/developer?id=LEMON+CLOVE+PTE.+LIMITED"
},
{
"type": "google_play_search_organic",
"rank_group": 5,
"rank_absolute": 5,
"position": "left",
"app_id": "com.free.vpn.super.hotspot.open",
"title": "VPN - Super Unlimited Proxy",
"url": "https://play.google.com/store/apps/details?id=com.free.vpn.super.hotspot.open",
"icon": "https://play-lh.googleusercontent.com/fd0tiWCj1DdmE0UtudWdNSrV7dppz2JCrmWQAV2JBw9e59qO_jmmlLe5o7y7NnbDog",
"reviews_count": null,
"rating": {
"rating_type": "Max5",
"value": 4.6706896,
"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": "Super Unlimited Inc.",
"developer_url": "https://play.google.com/store/apps/developer?id=Super+Unlimited+Inc."
}
]
}
]
}
]
}
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.
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.
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 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
}
},
{
"type": "app_store_search_organic",
"rank_group": 2,
"rank_absolute": 2,
"position": "left",
"app_id": "443369807",
"title": "HotspotShield VPN & Wifi Proxy",
"url": "https://apps.apple.com/us/app/hotspotshield-vpn-wifi-proxy/id443369807",
"icon": "https://is5-ssl.mzstatic.com/image/thumb/Purple116/v4/3f/bc/96/3fbc96f7-00ef-3130-4b99-cc91afcecf08/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
"reviews_count": 148613,
"rating": {
"rating_type": "Max5",
"value": 4.46541,
"votes_count": 148613,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
}
},
{
"type": "app_store_search_organic",
"rank_group": 3,
"rank_absolute": 3,
"position": "left",
"app_id": "946659216",
"title": "Best VPN Proxy Betternet",
"url": "https://apps.apple.com/us/app/best-vpn-proxy-betternet/id946659216",
"icon": "https://is2-ssl.mzstatic.com/image/thumb/Purple112/v4/be/f4/b5/bef4b56e-531c-6b19-e463-0a64e14d0cb0/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
"reviews_count": 190013,
"rating": {
"rating_type": "Max5",
"value": 4.51985,
"votes_count": 190013,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
}
},
{
"type": "app_store_search_organic",
"rank_group": 4,
"rank_absolute": 4,
"position": "left",
"app_id": "1193154948",
"title": "VPN 360 - Unlimited VPN Proxy",
"url": "https://apps.apple.com/us/app/vpn-360-unlimited-vpn-proxy/id1193154948",
"icon": "https://is4-ssl.mzstatic.com/image/thumb/Purple122/v4/4f/e1/63/4fe163f9-736d-7e88-64df-7ad1c3c6bdd9/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
"reviews_count": 296305,
"rating": {
"rating_type": "Max5",
"value": 4.67706,
"votes_count": 296305,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
}
},
{
"type": "app_store_search_organic",
"rank_group": 5,
"rank_absolute": 5,
"position": "left",
"app_id": "1282216562",
"title": "VPN - Unlimited Best VPN Proxy",
"url": "https://apps.apple.com/us/app/vpn-unlimited-best-vpn-proxy/id1282216562",
"icon": "https://is3-ssl.mzstatic.com/image/thumb/Purple126/v4/35/a5/a4/35a5a4e1-4c96-f70b-ebf0-d2f00a45fe6f/AppIcon-1x_U007emarketing-0-7-0-sRGB-85-220.png/512x512bb.jpg",
"reviews_count": 136720,
"rating": {
"rating_type": "Max5",
"value": 4.66024,
"votes_count": 136720,
"rating_max": 5
},
"is_free": true,
"price": {
"current": 0,
"regular": null,
"max_value": null,
"currency": "USD",
"is_price_range": false,
"displayed_price": null
}
}
]
}
]
}
]
}