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.

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