Google Play API documentation
We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:
- The Google Play API returns 40 reviews per request.
- The order in which reviews are returned is by date, from newest to oldest.
- You can get all reviews from a single place by using the
page_tokenparameter. Unlike other integrations, the Google Play api doesn't support the offset parameter to paginate the results. Instead the pages need to be iterated one by one. To do this, each response comes with anext_page_tokenfield. You can use the value is field to pass it as thepage_tokenparameter in a new request to get the next page in the results.
To get reviews from Wextractor you will need to perform GET requests against
the https://wextractor.com/api/v1/reviews/googleplay endpoint.
Reviews endpoint parameters:
| Parameter | Required | Description | Example |
|---|---|---|---|
| auth_token | Required | Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. | - |
| id | Required | A textual identifier that uniquely identifies an app in Google Play. This identifier is a part of the path that appears in the url for the app. For example, if the url for the app in Google Play is https://play.google.com/store/apps/details?id=com.whatsapp the identifier is: com.whatsapp
|
com.whatsapp |
| page_token | Optional | This parameter defines the token to use for pagination. After getting the first page of results without
sending the page_token parameter. The response will include a next_page_token field. To get the following page of results you need to create a new request adding the value of that field as the page_token parameter.
|
- |
| hl | Optional | This is the "host language" parameter that Google uses accross its products. It's used to determine
the language for the results. This setting defaults to en (English).
The setting expects a two letter language code as defined in ISO 639-1.
|
en |
Example usage:
https://wextractor.com/api/v1/reviews/googleplay?auth_token=XXXX&id=cc.forestapp
Example response:
{
"reviews": [
{
"id": "8cd3d3de-b39f-4a42-b8ce-3db3bb91b7c8",
"reviewer": "Bubble_ plays",
"text": "Amazing app. Helps focus in studies as well as we get to plant cute trees and make our own forest. I love this app totally recommend if you are looking for a app which helps you focus in studies",
"datetime": "2022-08-27T11:16:39",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=8cd3d3de-b39f-4a42-b8ce-3db3bb91b7c8",
"helpful_votes": 0
},
{
"id": "9de916f6-4795-4a09-8189-3614326ad1b3",
"reviewer": "Muhammad Shamshad",
"text": "😍😍",
"datetime": "2022-08-27T10:47:35",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=9de916f6-4795-4a09-8189-3614326ad1b3",
"helpful_votes": 0
},
{
"id": "bfcfe11f-49a6-42bf-a1d6-391183d56cee",
"reviewer": "Gsh",
"text": "Good",
"datetime": "2022-08-27T09:04:41",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=bfcfe11f-49a6-42bf-a1d6-391183d56cee",
"helpful_votes": 0
},
{
"id": "91101c5a-c3a3-4dd5-9caa-0178e5462aae",
"reviewer": "Tv Time",
"text": "I need a button to pause the time and the will be perfect 😊",
"datetime": "2022-08-27T08:23:40",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=91101c5a-c3a3-4dd5-9caa-0178e5462aae",
"helpful_votes": 0
},
{
"id": "5970e912-ffa6-45a9-b02c-d680834472ca",
"reviewer": "Sanjeevani Kumari",
"text": "it should allow some useful apps.",
"datetime": "2022-08-27T07:52:17",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=5970e912-ffa6-45a9-b02c-d680834472ca",
"helpful_votes": 0
},
{
"id": "abe8ca19-83dd-43b7-88a1-f3f5916c5550",
"reviewer": "Neil",
"text": "Good app, I wish there was an option for upto 5hrs timer mode.",
"datetime": "2022-08-27T06:38:33",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=abe8ca19-83dd-43b7-88a1-f3f5916c5550",
"helpful_votes": 0
},
{
"id": "5628228c-7ed2-4cc5-9e14-e63895232d51",
"reviewer": "Jayesh Tiwari",
"text": "Helps me focus. Great app.",
"datetime": "2022-08-27T05:46:29",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=5628228c-7ed2-4cc5-9e14-e63895232d51",
"helpful_votes": 0
},
{
"id": "c7ab1a45-4b53-4333-ba68-481d68e71291",
"reviewer": "Abhishek Jha",
"text": "Extremely great app for productivity",
"datetime": "2022-08-27T05:25:47",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=c7ab1a45-4b53-4333-ba68-481d68e71291",
"helpful_votes": 0
},
{
"id": "a1ed48fb-3fef-4cb4-a57b-a16b75845363",
"reviewer": "Khushi Rangoon",
"text": "I honestly get a lot of work done with this app, I recommend.",
"datetime": "2022-08-27T03:10:22",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=a1ed48fb-3fef-4cb4-a57b-a16b75845363",
"helpful_votes": 0
},
{
"id": "b2a11294-2e0b-42d8-9ed3-6fbc7058ba63",
"reviewer": "Eman Helal",
"text": "تطبيق روعة بيظبط الوقت",
"datetime": "2022-08-27T01:59:10",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=b2a11294-2e0b-42d8-9ed3-6fbc7058ba63",
"helpful_votes": 0
},
{
"id": "d32c024c-829c-4a96-b11d-bddaf8b1b3ef",
"reviewer": "abigail adetunji",
"text": "Good app helps me a lot",
"datetime": "2022-08-26T20:47:34",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=d32c024c-829c-4a96-b11d-bddaf8b1b3ef",
"helpful_votes": 0
},
{
"id": "b0667f8d-808c-41cd-96cf-e8884128bf31",
"reviewer": "Sandeep Pal",
"text": "Nice",
"datetime": "2022-08-26T20:10:20",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=b0667f8d-808c-41cd-96cf-e8884128bf31",
"helpful_votes": 0
},
{
"id": "d387f8f4-44c5-4f12-8e28-ec9a24a9f21f",
"reviewer": "Jack Ness",
"text": "App runs smoothly or at least I have seen no bugs. It does a great job keeping me motivated to study. I would just like to see more tree varieties even if it's just more coniferous trees.",
"datetime": "2022-08-26T19:34:34",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=d387f8f4-44c5-4f12-8e28-ec9a24a9f21f",
"helpful_votes": 0
},
{
"id": "ee7ac820-cc82-429b-b1d2-309f4ba4b9f0",
"reviewer": "Daria Bolborea",
"text": "The cutest and the most wonderful app I have ever tried! It makes me happy even when I have a bad day, because seeing those little plants growing gives me a great feeling. Also, it makes me be more motivated to do all the study needed!",
"datetime": "2022-08-26T19:00:43",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=ee7ac820-cc82-429b-b1d2-309f4ba4b9f0",
"helpful_votes": 0
},
{
"id": "71fc0ff9-f3cd-46bc-a969-3b539c77fa3c",
"reviewer": "Zeinab Sadegh ahmadi",
"text": "Awesome that's it",
"datetime": "2022-08-26T18:00:11",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=71fc0ff9-f3cd-46bc-a969-3b539c77fa3c",
"helpful_votes": 0
},
{
"id": "e39b66b8-a1e8-438b-a004-7d0851128f49",
"reviewer": "Mahmudul Hasan",
"text": "Very good app . I can now focus in my study. I recommend this app for better future.",
"datetime": "2022-08-26T17:34:12",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=e39b66b8-a1e8-438b-a004-7d0851128f49",
"helpful_votes": 0
},
{
"id": "987eafd3-cb31-4783-aea7-b01f97bc9bd4",
"reviewer": "Brian Malott",
"text": "Brilliant idea! Such a novel pomodoro concept. The add-ons are the best part. Thank you!",
"datetime": "2022-08-26T17:26:34",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=987eafd3-cb31-4783-aea7-b01f97bc9bd4",
"helpful_votes": 0
},
{
"id": "401c47be-8697-4f3e-a533-ea565adafaa3",
"reviewer": "Yessica Puente",
"text": "Excellent!",
"datetime": "2022-08-26T17:12:32",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=401c47be-8697-4f3e-a533-ea565adafaa3",
"helpful_votes": 0
},
{
"id": "b1fbe0c9-762e-4287-a87e-d604f56d100f",
"reviewer": "Marina Nabil",
"text": "💕",
"datetime": "2022-08-26T17:05:05",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=b1fbe0c9-762e-4287-a87e-d604f56d100f",
"helpful_votes": 0
},
{
"id": "becfe85b-c298-473e-9530-bdbcbbb9e7c0",
"reviewer": "janeya d'costa`",
"text": "The best experience so far.",
"datetime": "2022-08-26T16:10:35",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=becfe85b-c298-473e-9530-bdbcbbb9e7c0",
"helpful_votes": 0
},
{
"id": "77520a9e-b0cc-4dd8-98fc-232cc67781c7",
"reviewer": "tashs 95•",
"text": "Great",
"datetime": "2022-08-26T15:34:51",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=77520a9e-b0cc-4dd8-98fc-232cc67781c7",
"helpful_votes": 0
},
{
"id": "e075029a-f3f9-4456-8131-b017c4fed7ff",
"reviewer": "PRANHITHA BURRI",
"text": "Very useful app this helps me a lot to focus😁",
"datetime": "2022-08-26T14:07:11",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=e075029a-f3f9-4456-8131-b017c4fed7ff",
"helpful_votes": 0
},
{
"id": "1c9bc2d5-0840-4d30-9ae4-d4c3f4f86ee6",
"reviewer": "Vannya Verma",
"text": "Really helpful app",
"datetime": "2022-08-26T12:28:43",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=1c9bc2d5-0840-4d30-9ae4-d4c3f4f86ee6",
"helpful_votes": 0
},
{
"id": "d60fc30d-1c13-42b6-b180-50822d7470a2",
"reviewer": "Anousha Moradi",
"text": "Love it😍",
"datetime": "2022-08-26T10:20:40",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=d60fc30d-1c13-42b6-b180-50822d7470a2",
"helpful_votes": 0
},
{
"id": "2460c599-2034-4f10-9c50-8ef068c3e45a",
"reviewer": "Sahar Yaghoubi",
"text": "Your app is really helpful... God bless you ♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️♥️",
"datetime": "2022-08-26T09:32:20",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=2460c599-2034-4f10-9c50-8ef068c3e45a",
"helpful_votes": 0
},
{
"id": "47eb6146-bd68-45c1-8e4d-3b95cf362923",
"reviewer": "aiolia_ chzn",
"text": "Such a good app to stay motivate for working and be concentrate on tasks. Well app !",
"datetime": "2022-08-26T09:16:51",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=47eb6146-bd68-45c1-8e4d-3b95cf362923",
"helpful_votes": 0
},
{
"id": "d7a9097c-b27d-46dd-999e-69c5cb280aec",
"reviewer": "Rajan Normal",
"text": "My activity improve and i predict my valuable time.",
"datetime": "2022-08-26T06:56:10",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=d7a9097c-b27d-46dd-999e-69c5cb280aec",
"helpful_votes": 0
},
{
"id": "6647cf45-3a85-40cc-9355-73514b23d10a",
"reviewer": "sutapa kundu",
"text": "In the world where ig,wp,tik tok ...etc etc exists to lead the way of destruction....apps like this are a savior✨",
"datetime": "2022-08-26T06:43:38",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=6647cf45-3a85-40cc-9355-73514b23d10a",
"helpful_votes": 0
},
{
"id": "639f0396-c757-4ece-a0e8-d00e39291a67",
"reviewer": "Javohir Mirtojiyev",
"text": "The app is very usefull for your improvment...",
"datetime": "2022-08-26T05:26:38",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=639f0396-c757-4ece-a0e8-d00e39291a67",
"helpful_votes": 0
},
{
"id": "347605d6-4e7b-4121-9ed6-03b363248d92",
"reviewer": "Jane Gordner",
"text": "Very cute and helpful",
"datetime": "2022-08-26T05:21:37",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=347605d6-4e7b-4121-9ed6-03b363248d92",
"helpful_votes": 0
},
{
"id": "7769411e-a7f7-47cd-948d-0ea0afd67093",
"reviewer": "audrey newell",
"text": "This app is so cute!!",
"datetime": "2022-08-25T22:52:56",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=7769411e-a7f7-47cd-948d-0ea0afd67093",
"helpful_votes": 0
},
{
"id": "23db69b6-e050-4a9b-af57-8910c16d8803",
"reviewer": "Omar Talal",
"text": "It does not lock the apps sometimes it dies fir a few minutes sometimes it doesn't at all",
"datetime": "2022-08-25T20:17:05",
"rating": "3",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=23db69b6-e050-4a9b-af57-8910c16d8803",
"helpful_votes": 0,
"reply": {
"text": "Hello,\nSorry for the inconvenience. Your app might have been closed from the background by your device system. Please turn off the option \"Wither the tree when Forest is closed\" in Forest's Settings and see if it helps. If the problem persists, please contact us again by emailing [email protected]. Thank you! :)",
"datetime": "2022-08-26T03:31:06"
}
},
{
"id": "1dcef44a-5384-4067-a8cf-b94151a50915",
"reviewer": "Subhojit Mukherjee",
"text": "It gives you the motivation to study because some plants and trees are really so expensive for purchase by the help of coins",
"datetime": "2022-08-25T19:09:12",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=1dcef44a-5384-4067-a8cf-b94151a50915",
"helpful_votes": 0
},
{
"id": "b537d669-9ee7-4fde-8a37-eb1ed8c70842",
"reviewer": "Brightni Joseph",
"text": "Great way to stay focus on your task, study, work etc.",
"datetime": "2022-08-25T16:54:37",
"rating": "4",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=b537d669-9ee7-4fde-8a37-eb1ed8c70842",
"helpful_votes": 0
},
{
"id": "dc41b86a-d4a2-43fe-b4a4-3cf5f1e164c3",
"reviewer": "Soumya Ranjan Adhikary",
"text": "This app is wonderful. When I start my study everyday I turn on the timer , when I see the complete grawn tree then I satisfie myself.but I request to the designer that to make the app lighter mb so that many of the student and workers can download this on their low mb device . Great job🥰🥰",
"datetime": "2022-08-25T16:48:44",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=dc41b86a-d4a2-43fe-b4a4-3cf5f1e164c3",
"helpful_votes": 0
},
{
"id": "85add65e-16f6-43a9-9953-3beb71676c37",
"reviewer": "Ayyagari Manojna",
"text": "It motivates me to work harder and it's really fun when he forest is full wih trees....and it also provides the overview of your focus time.. I have only one complaint....there should be an alarm or a pop up sound when a task is completed...if you dont notice the task will be completed and the extra time you did wouldn't be counted",
"datetime": "2022-08-25T16:19:19",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=85add65e-16f6-43a9-9953-3beb71676c37",
"helpful_votes": 0
},
{
"id": "cebeca0e-1083-4abf-a6f8-44ecb37cf186",
"reviewer": "Mark Musk",
"text": "Great app thanks",
"datetime": "2022-08-25T16:03:23",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=cebeca0e-1083-4abf-a6f8-44ecb37cf186",
"helpful_votes": 0
},
{
"id": "462a8a05-ea72-4d67-9ab3-88837b5b9875",
"reviewer": "Rebeca Portilla",
"text": "Great app",
"datetime": "2022-08-25T15:59:44",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=462a8a05-ea72-4d67-9ab3-88837b5b9875",
"helpful_votes": 0
},
{
"id": "dbcb5031-6498-4628-9b6d-ea7a1cae028a",
"reviewer": "Olivia Smith Rodrigues",
"text": "Really easy to use thus far and very cute!",
"datetime": "2022-08-25T14:20:00",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=dbcb5031-6498-4628-9b6d-ea7a1cae028a",
"helpful_votes": 0
},
{
"id": "8660c69e-82c1-4dce-9627-9c24a1f27cbe",
"reviewer": "Rajib Islam",
"text": "This app has helped me a lot to focus on my study.l love it",
"datetime": "2022-08-25T14:03:42",
"rating": "5",
"url": "https://play.google.com/store/apps/details?id=cc.forestapp&reviewId=8660c69e-82c1-4dce-9627-9c24a1f27cbe",
"helpful_votes": 0
}
],
"totals": {
"average_rating": "4.7",
"review_count": 505490,
"stars_count": {
"5_stars": 410923,
"4_stars": 58965,
"3_stars": 17764,
"2_stars": 6541,
"1_stars": 11223
}
},
"next_page_token": "Cn4KfAp6MCxUSU1FU1RBTVAgIjIwMjItMDgtMjUgMTQ6MDM6NDIuMTI3MzgyKzAwIiwxMDQwMTY0MjkwNjU0LCJodHRwOi8vbWFya2V0LmFuZHJvaWQuY29tL2RldGFpbHM_aWQ9djI6Y2MuZm9yZXN0YXBwOjEiLDEsZmFsc2U"
}
Example of getting all reviews in python:
import requests
import json
auth_token = 'your token'
app_id = 'com.whatsapp'
url = 'https://wextractor.com/api/v1/reviews/googleplay?auth_token=' + auth_token + '&id=' + app_id
all_reviews = []
reviews = json.loads(requests.get(url).text)
all_reviews += reviews['reviews']
while reviews.get('next_page_token'):
page_url = url + '&page_token=' + reviews['next_page_token']
reviews = json.loads(requests.get(page_url).text)
all_reviews += reviews['reviews']
print(reviews)