How do I get app reviews from Google Play and App Store?
With the new App Data API, you can easily collect reviews on any mobile application published on Google Play or App Store. To do that, use the Google App Reviews and Apple App Reviews endpoints.
Collecting reviews from Google Play
1 Call the Google App Reviews Task POST endpoint.
POST https://api.dataforseo.com/v3/app_data/google/app_reviews/task_post
2 Specify the ID of the app you wish to collect reviews on in the app_id field.
The app_id parameter can be found on the Google Play website as a part of the 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
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 reviews to be returned in the API response. To do that, add the depth parameter and set it to the desired value.
We strongly recommend setting the parsing depth in the multiples of 150 as our system processes 150 reviews in a row. Thus, if you specify depth as 151 you will be charged for 300 reviews.
Default depth value: 150.
Maximum depth value: 5000.
6 You can also filter reviews by rating by adding the rating parameter. It can take the following values:
• 5 — return reviews with five-star rating only;
• 4 — return reviews with four-star rating only;
• 3 — return reviews with three-star rating only;
• 2 — return reviews with two-star rating only;
• 1 — return reviews with one-star rating only.
By default, the API returns all reviews regardless of the number of stars they have.
7 In addition to that, you can sort the results with the sort_by parameter. Possible values:
• newest — sort by the most recent reviews;
• most_relevant — sort by the most relevant reviews;;
• rating — sort by rating.
Default rule: most_relevant
Your POST request should be structured as in the following example:
[
{
"app_id": "org.telegram.messenger",
"location_code": 2840,
"language_code": "en",
"depth": 150,
"rating": 5
}
]
8 Send your request and use the Task ID from the response to retrieve the results from the Google App Reviews Task GET Advanced endpoint.
GET https://api.dataforseo.com/v3/app_data/google/app_reviews/task_get/advanced/$id
In the API response, you will find reviews for the specified application along with review ratings, review content, user profile info of each reviewer, review publication dates, and more data.
{
"version": "0.1.20220428",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0861 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "05161100-2806-0425-0000-d7f1ed81a114",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0369 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"app_data",
"google",
"app_reviews",
"task_get",
"advanced",
"05161100-2806-0425-0000-d7f1ed81a114"
],
"data": {
"se_type": "reviews",
"se": "google",
"api": "app_data",
"function": "app_reviews",
"app_id": "org.telegram.messenger",
"location_code": 2840,
"language_code": "en",
"depth": 150,
"rating": 5,
"device": "desktop",
"os": "windows"
},
"result": [
{
"app_id": "org.telegram.messenger",
"type": "reviews",
"se_domain": "play.google.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://play.google.com/store/apps/details?id=org.telegram.messenger&hl=en&gl=us&showAllReviews=true",
"datetime": "2022-05-16 08:00:24 +00:00",
"title": null,
"rating": null,
"reviews_count": null,
"items_count": 150,
"items": [
{
"type": "google_play_reviews_search",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"version": "8.7.4",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2022-05-09 16:16:40 +00:00",
"helpful_count": 906,
"title": null,
"review_text": "Can be used in lieu of multiple applications. I use it for texting, calling, video chat, taking pictures, video recording messages/notes, group chats, group pages, regular notepad, gallery, editing, saving important data, meeting people with similar interests and a million other things. Can use on multiple devices simultaneously. Privacy is a non-issue. My favorite app.",
"user_profile": {
"profile_name": "Samantha T Vargas",
"profile_image_url": "https://play-lh.googleusercontent.com/a-/AOh14GhP7hGUsEbYETyg2gM2TzNMImG9dpceHPm4_FWE"
},
"responses": null
},
{
"type": "google_play_reviews_search",
"rank_group": 2,
"rank_absolute": 2,
"position": "left",
"version": "8.5.4",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2022-03-11 00:33:20 +00:00",
"helpful_count": 1005,
"title": null,
"review_text": "So far it's easy to use and I love the little touches of animation that they have Incorporated into all the functions. For example there is an endless amount of stickers from all areas of pop culture and they are animated. Even when you like a post, you see a little animation and others can see it in real time as well, knowing that the post just received a new like.",
"user_profile": {
"profile_name": "Jonathan Heenan",
"profile_image_url": "https://play-lh.googleusercontent.com/a-/AOh14GiA_iezZqOlboyvqB_z0ObiDK-JLCFrndXYq5tpOg"
},
"responses": null
},
{
"type": "google_play_reviews_search",
"rank_group": 3,
"rank_absolute": 3,
"position": "left",
"version": "8.5.4",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2022-03-11 12:21:28 +00:00",
"helpful_count": 752,
"title": null,
"review_text": "Excellent. Always works. When texts aren't going through, my sister and I connect over Telegram. It's also a very convenient way to get files from my phone onto my computer and vice versa, I just send them to myself. Stickers are awesome and it's easy to add your own, which I've had fun with. The customizeable backgrounds are nice. I don't have anything bad to say, it just always works as it's meant to.",
"user_profile": {
"profile_name": "Corinne Hunter",
"profile_image_url": "https://play-lh.googleusercontent.com/a-/AOh14GhOmSCeJ5435X74qs_S4gc7OCeEzNhKgaJSbgiT8w"
},
"responses": null
},
{
"type": "google_play_reviews_search",
"rank_group": 4,
"rank_absolute": 4,
"position": "left",
"version": "8.5.4",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2022-03-08 16:32:34 +00:00",
"helpful_count": 381,
"title": null,
"review_text": "Fantastic secure messaging app. Highly effective UI makes it easy to sort through messages, edit or delete texts, pin or schedule messages, and of course the most important part - THEY HAVE THE BEST STICKERS EVER. Like most people I am stuck using a portfolio of messaging apps for friends who \"only\" use one - this is the one to rule them all for efficiency, features, prioritization of privacy, and ease of use.",
"user_profile": {
"profile_name": "marushka grogan",
"profile_image_url": "https://play-lh.googleusercontent.com/a-/AOh14GguzEoSZOqs6j_aZmlBnMif6fx0AS1XKEFN4J7wmZM"
},
"responses": null
},
{
"type": "google_play_reviews_search",
"rank_group": 5,
"rank_absolute": 5,
"position": "left",
"version": "8.4.0",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2021-12-29 19:20:37 +00:00",
"helpful_count": 1165,
"title": null,
"review_text": "Im visually impaired, and its great to be able to use TalkBack, and turn it on while youre in the app. You cant do that on me***nge*. If I get a message, and my screen reader is off after clicking on it, I have to exit, turn my screen reader on, then go back to Me***nge*. Also my reader in Me***nge* will not read what the stickers are, but it will in Telegram. Im very appreciative to you guys for that. It makes it a lot easier, especially looking for stickers to send. Font can be enlarged also!",
"user_profile": {
"profile_name": "Elisheva Freely",
"profile_image_url": "https://play-lh.googleusercontent.com/a-/AOh14Ggmn79OsW-3k_lIEj4-hFUuexiJnLYnf-6-5MZgrDw"
},
"responses": null
}
]
}
]
}
]
}
Collecting reviews from App Store
1 Call the Apple App Reviews Task POST endpoint.
POST https://api.dataforseo.com/v3/app_data/apple/app_reviews/task_post
2 Specify the ID of the app you wish to collect reviews on in the app_id field.
The app_id parameter can be found on the App Store website as a part of the URL pointing to a specific mobile application. For example, here is the URL of the Telegram app on App Store:
https://apps.apple.com/us/app/telegram-messenger/id686449807
The app_id of this app is 686449807
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 reviews to be returned in the API response. To do that, add the depth parameter and set it to the desired value.
We strongly recommend setting the parsing depth in the multiples of 50 as our system processes 50 reviews in a row. Thus, if you specify depth as 51 you will be charged for 100 reviews.
Default depth value: 50.
Maximum depth value: 500.
6 You can also sort the results with the sort_by parameter. Possible values:
• most_recent — sort by the most recent reviews;
• most_helpful — sort by the most relevant/helpful reviews.
Default rule: most_helpful
Your POST request should be structured as in the following example:
[
{
"app_id": "686449807",
"location_code": 2840,
"language_code": "en",
"depth": 50
}
]
7 Send your request and use the Task ID from the response to retrieve the results from the Apple App Reviews Task GET Advanced endpoint.
GET https://api.dataforseo.com/v3/app_data/apple/app_reviews/task_get/advanced/$id
In the API response, you will find reviews for the specified application along with review ratings, review content, user profile info of each reviewer, review publication dates, and more data.
{
"version": "0.1.20220428",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0762 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "05161106-2806-0425-0000-2ac70864adc0",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0239 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"app_data",
"apple",
"app_reviews",
"task_get",
"advanced",
"05161106-2806-0425-0000-2ac70864adc0"
],
"data": {
"se_type": "reviews",
"se": "apple",
"api": "app_data",
"function": "app_reviews",
"app_id": "686449807",
"location_code": 2840,
"language_code": "en",
"depth": 50,
"device": "desktop",
"os": "windows"
},
"result": [
{
"app_id": "686449807",
"type": "reviews",
"se_domain": "itunes.apple.com",
"location_code": 2840,
"language_code": "en",
"check_url": "https://apps.apple.com/us/app/id686449807?see-all=reviews",
"datetime": "2022-05-16 08:06:55 +00:00",
"title": null,
"rating": null,
"reviews_count": null,
"items_count": 50,
"items": [
{
"type": "app_store_reviews_search",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"version": "7.8.4",
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2021-07-24 13:51:42 +00:00",
"title": "Secure, Easy to Use",
"review_text": "OVERALL If you’re tired of companies like facebook reading your messages, yes they really do, it’s time to up your game. Telegram and Signal are both great apps, Telegram being a bit easier, and polished. Telegram chats use two modes. In standard mode messages are encrypted and stored on their servers. In “padlock” mode messages are encrypted and stored on your device. Both are secure, however in “padlock” mode if you, for instance, buy a tablet and install Telegram it won’t show your messages from other devices. Remember, enable touch ID on your phone/iPad/macOS device and Telegram, otherwise anyone could physically access the device and read your conversations. SUGGESTED IMPROVEMENT FOR DEVS It could use one improvement, when you share via iOS it needs to have both the standard AND a “padlock” icon for secure chat. Otherwise you’ll end up with two different chats with each friend. Until then you need to select share, Telegram, and manually pick the right chat.\n\nAlso, make the “read” checkmark color customizable or bold. Or better use an “o” for unread and a check for read.",
"user_profile": {
"profile_name": "mov ax,1/int 21h",
"profile_image_url": null
}
},
{
"type": "app_store_reviews_search",
"rank_group": 2,
"rank_absolute": 2,
"position": "left",
"version": "7.4.2",
"rating": {
"rating_type": "Max5",
"value": 3,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2021-02-18 14:00:42 +00:00",
"title": "In desperate need of Group Video Chat",
"review_text": "Hey, I’ve been using Telegram for over 10+ years and I haven’t had any problems with this application whatsoever everything works great but, there is one issue that I have with this application and that is the inability to create a group video chat that is why I can only give telegram 3 stars. I honestly believe that is a crucial disadvantage to this application I say that because, I have family and friends that live all over the world whether it be in different states or different countries and we all have telegram on our phones. That being said we would like to I’ll be able to talk in a video group chat with each other which we are unable to because this application doesn’t provide that option. So therefore since telegram doesn’t provide a video group chat option we have to download another application to be able to do that Task. Which in my opinion is extremely ridiculous because you should be able to perform the test on this app as well. Instead of making people waste valuable space on their phones by download in other apps to perform the test where y’all can provide that ability on your app so we don’t have to download other apps to perform that and we could save space on our Devices.",
"user_profile": {
"profile_name": "Mr.. Fisher",
"profile_image_url": null
}
},
{
"type": "app_store_reviews_search",
"rank_group": 3,
"rank_absolute": 3,
"position": "left",
"version": "5.11.1",
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2019-09-20 15:54:38 +00:00",
"title": "Need Video calling feature, faster passcode lock & a bug fix",
"review_text": "I am enjoying telegram as my main chatting app as it’s secure faster & fun to use! But unfortunately it has only voice calling feature which makes me to use another apps for that feature only! I cordially expect that developer will add that asap! \n\nIt’s passcode locking feature in order to provide best security to its user, but apps lock doesn’t work immediately! Which should be must! The minimum time is 1 minutes! It should be locked within a fraction of second as some other apps do! As long as we have face unlocking feature so it will not bother us! \nLastly, I have facing an unexpected issue sometimes! I’m not sure where I tap but when it happens telegram stop functioning & start glitching non stop glitching! It needs the apps to launch again! \nSo please make the apps more lovely by adding video calling features and make the passcode lock more quicker & fix the bug! Thanks for reading with patience!",
"user_profile": {
"profile_name": "Zakir Hosen",
"profile_image_url": null
}
},
{
"type": "app_store_reviews_search",
"rank_group": 4,
"rank_absolute": 4,
"position": "left",
"version": "6.1.2",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2020-05-30 05:14:18 +00:00",
"title": "Deleted messages",
"review_text": "The genuine telegram app deletes text messages from both sides but the third party apps keeps those messages and that is not good because it invades the peoples privacy status and sometimes they have the whole conversation sent to others even if it was confidential, for example if you saved a wrong number and then wrote a text or sent a photo then realized that its the wrong account and deleted it but yet if that person is using the “ third party apps” then he will still have those texts, photos, and user information and for me that is a major flaw in your agreement to them. I wish you can fix that problem or get rid of those apps and save other peoples sanity. \nOverall I love the Genuine app its so slick easy and so much comfortable to use I have been using it for the past 3 & 1/2 years and it never let me down. Keep up the good work and please check your agreements with the third party apps.\nThanks in advance",
"user_profile": {
"profile_name": "Mr Bcubed",
"profile_image_url": null
}
},
{
"type": "app_store_reviews_search",
"rank_group": 5,
"rank_absolute": 5,
"position": "left",
"version": "8.6.1",
"rating": {
"rating_type": "Max5",
"value": 1,
"votes_count": null,
"rating_max": 5
},
"timestamp": "2022-04-10 16:19:08 +00:00",
"title": "iOS Home swipe gesture glitch",
"review_text": "1. When I use swipe up gesture - I’m accidentally Join Chat(which I just opened to browse it, not join!). Join chats should be located somewhere else or there should be warning popup- Are you sure to join chat? 2. Glitch: Using latest iPadOS and iPad Pro. Also, another big problem- poor sound from my side, I can hear opponent in call perfectly), but me is like microphone is too far away(that’s opponent in call telling me about what he hear during call, quality is terrible). I’m using my iPad Pro 12.9 M1 near me in close 30cm distance and mics and not covered. In Zoom call everything is perfect with the same person, with the same conditions, so this is definitely telegram problem! Just tested: on MacBook Pro sound is clear, with the same person, but using iPhone/iPad - sound is crap, too low. 3).Also, now I tried iPhone 13 Pro and got the same issue! Using headphones improves quality a bit, but anyway it’s awful. Again, I can hear opponent perfectly. Also, my internet is 100mb/sec optical and stable. Another bug: Search in chats are crap. I’ve sent a lot of links too AliExpress and searching word “ali” doesn’t give’s anything!",
"user_profile": {
"profile_name": "Olоlо",
"profile_image_url": null
}
}
]
}
]
}
]
}