App Store reviews 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 App Store API returns 10 reviews per request.
  • The order in which reviews are returned is by the predefined order returned by apple. It's not possible to return reviews from newest to oldest.
  • You can get all reviews from a single place by using the offset parameter.
  • By default only the reviews from the United States will be returned, you can select the country to use with the country parameter as described below.

To get reviews from Wextractor you will need to perform GET requests against the 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 the App Store. This identifier can be taken from the url in the App Store. For example, if the url for the an app in the App Store is the identifier is 310633997 310633997
offset Optional This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 30 is the 3rd page of results, etc.). 10
country Optional With this optional parameter you can filter reviews by their country. By default the country code is US. List of country codes us

Example usage:

Example response:

            "reviews": [
                    "id": "8484086363",
                    "rating": "5",
                    "datetime": "2022-03-22T18:15:33Z",
                    "title": "Couldn’t ask for a better app to communicate with loved ones",
                    "reviewer": "briana_.ceu",
                    "text": "I absolutely adore this app. It keeps me connected with my friends and family at all times. The chat features are amazing. One of the features I love about WhatsApp is the saving a chat message which has the star icon. I use it all the time to save important and special sweet messages from my friends and family. WhatsApp even lets me look at all the saved messages in that conversation under the contact which I really appreciate. WhatsApp settings are very easy to get around with and with no problems. Another feature I love is the Preview feature. When I’m going to a public place where I could possibly forget my phone somewhere and I don’t want my messages to be seen or in another case I want privacy I use that feature. I also like the customizable sound notifications for each contact. I absolutely am grateful for this app!"
                    "id": "7210260956",
                    "rating": "1",
                    "datetime": "2021-04-11T13:34:25Z",
                    "title": "App got worse after no choice then having to update",
                    "reviewer": "CST&RT",
                    "text": "What happened to what’s app after the update. It got worse. What about being able to delete what you sent on both sides nit just from my chat, it used to not any more! You said there were improvements? Not at all! Improvements doesn’t mean to take away what worked well for many. improvements is enhancing adding not removing what works. What a disappointment this app fell short! Many feel the same! Security? That probably won’t be secure either anymore! Let’s see what will happen going forward with all the breaches and the  unsecured  and less encryption . I can go on and on. If you say you will improve, then do as you promise! What happened to what’s app after the update. It got worse. What about being able to delete what you sent on both sides nit just from my chat, it used to not any more! You said there were improvements? Not at all! Improvements doesn’t mean to take away what worked well for many. improvements is enhancing adding not removing what works. What a disappointment this app fell short! Many feel the same! Security? That probably won’t be secure either anymore! Let’s see what will happen going forward with all the breaches and the  unsecured  and less encryption . I can go on and on. If you say you will improve, then do as you promise!",
                    "reply": {
                        "text": "Thanks for the review.\n\nPlease note that you only have about **an hour** after you've sent a message to delete for everyone.\n\nMessages that are successfully deleted for everyone will be replaced with:\n\n“**This message was deleted**”\n\nTo delete messages for everyone:\n\n1. Open the WhatsApp chat containing the message you want to delete.\n2. Tap and hold the message :: tap **Delete**.\n* Optionally, select more messages to delete multiple messages at once.\n\n\n3. Tap the **trash can** icon :: **Delete For Everyone**.\n\n**Note**:\n\n* In order for messages to be successfully deleted for everyone, both you and your recipient must be using the latest version of WhatsApp.\n* Recipients using WhatsApp for iOS may still have media you sent saved to their Photos, even after the message is deleted from the WhatsApp chat.\n* Recipients may see your message before it's deleted or if deletion wasn’t successful.\n* You won’t be notified if deleting for everyone wasn’t successful.\n* You only have about an hour after you've sent a message to request to **Delete for Everyone**"
                    "id": "8695417915",
                    "rating": "2",
                    "datetime": "2022-05-22T03:29:54Z",
                    "title": "Never seen a more garbage communication app",
                    "reviewer": "officialkei",
                    "text": "Just to clarify I have been using WhatsApp for several years, if I had to guess it would be over 4 years, I have plenty of friends that use it and swear by it but I cannot fathom how frustrating it is to use sometimes. I came on here to express one thing and one thing only. \n\nMany of my colleagues use this app to video chat and to send text. I have added many contacts using WhatsApp however when I try to send a message or call these new contacts i am left with only inviting them to use the app, rendering the app completely useless at times. Allow me to specify my problem.\n\nSay for example I added a new phone number in my contacts list. I close the app to then open WhatsApp, I try to search for the new contact. I find the name, but when I try to send a message the only choice I have is to invite. This is mostly frustrating when I first add someone but I have contacts from a year ago that still need an invitation when they so clearly use the app on a daily basis. As long as this problem persists I don’t see myself using the app long term, if it wasn’t for this issue I would be ecstatic about the development. For now I’m disappointed and at a loss of words for how I would feel going forward."
                    "id": "8753994852",
                    "rating": "1",
                    "datetime": "2022-06-08T16:10:15Z",
                    "title": "Won’t restore my data",
                    "reviewer": "Khara&batata",
                    "text": "I had an issue with receiving notifications from this app for about two months. I did everything: turning off and on the notifications from the app and my phone, shutting off my phone, resetting it, updating my phone and the app many times. Then I decided to just delete the app and reinstall. It did the trick. However now, I can’t back up my media on the app because of storage space. I’ve deleted over 2k of photos and videos from my gallery, deleted more than half my apps on my phone, and cleared/deleted multiple chats on iMessage and WhatsApp. I finally reached to the point where I was able to backup my stuff. It worked for a while, but then the app shut down. Once I opened it again, it told me I had to clear 5.34GB again. After deleting all those things, I’m required to delete more. My phone capacity is 128GB and my phone only holds 83GB. I don’t understand where the issue is and why this is happening. No, I did not contact WhatsApp support. I’ve contacted them with my other issue and I didn’t not receive much help. This won’t be any different. It’s frustrating. This issue doesn’t seem to happen to anyone else I know, just with me."
                    "id": "8637516468",
                    "rating": "5",
                    "datetime": "2022-05-04T21:10:57Z",
                    "title": "Anytime Anywhere App - WhatsApp changed the way we communicate.",
                    "reviewer": "Austingiltus",
                    "text": "WhatsApp will go in history as an App which change the way across the globe how we communicate. Just downloaded as a chat app to connect local friends planning weekend meetup. Now No international calling cards, all my family and friends, I call them via audio and video calls via WhatsApp. For Work, Professional Network, Professional Network, for connecting with people of same geographical area, same interest I manage more than 1500 different WhatsApp groups. WhatsApp you are amazing. I am still waiting for the feature when Admin can delete messages posted by spammers in groups and remove and delete a spammer from all groups with single click. Wrote to WhatsApp Team few times and still waiting for that Admin Privilege. Thanks WhatsApp, you have become “Anytime Anywhere App” for billions including me."
                    "id": "5876332943",
                    "rating": "5",
                    "datetime": "2020-04-28T18:50:17Z",
                    "title": "WhatsApp- A Great End to End Encryption Platform",
                    "reviewer": "@njiban",
                    "text": "I am particularly fascinated with WhatsApp because of its versatility and agility as far as social media platforms are concerned. It takes customer privacy and security into great context and go out of their way to protect that customer information from 3rd parties and hackers. I have never heard of a hack or security breach into WhatsApp security systems. Overall the App has been great and has eased the way the world has connected via talking and sharing digital and graphical data. \n\nThe only downside to WhatsApp is that when you lose your device or are out of storage and uninstall the app, you typically lose all your previous chats and data. I would have been great if WhatsApp had an option for optional storage space for sale, for folk to backup their communication and social media data. \n\nThank you"
                    "id": "6938294479",
                    "rating": "1",
                    "datetime": "2021-02-01T00:53:50Z",
                    "title": "From Bad to Worse",
                    "reviewer": "Silks777",
                    "text": "What was once a wonderful secure platform is fast becoming a laughingstock ever since it was touched by Facebook. So thoroughly disappointed. Relatives abroad had told me that Facebook is phasing out WhatsApp but demands that we give them all our contact details; I’m not for that. Apparently, In the UK, WhatsApp was given customers until the first week of February before they close an account if the customer refused to except terms to the detriment of customer privacy. Now there is a delay to this change? It’s still going to happen so why the delay? Could it be that this delay is to collect our information anyway without a permission, anyway? I have now started looking for a replacement to WhatsApp. I am sorry to be parting company with you but it isn’t the secure independent platform it once was and the quality has progressively deteriorated. To be honest, if I could opt for zero stars that would be the level at this point. I’ve been trying to speak to others over the platform but I’ve spent more time trying to reconnect or redial and it’s just not worth it.  Another competitor bows out."
                    "id": "1804147488",
                    "rating": "4",
                    "datetime": "2017-09-22T19:40:20Z",
                    "title": "Camera takes fuzzy photos every time",
                    "reviewer": "kylehotchkiss",
                    "text": "WhatsApp in general is fine. But every photo I take in the app is fuzzy; and more zoomed in than my normal photos app. It’s like they are putting camera in video mode and taking a screenshot. I guess this is part of their cross platform library but still, I wish it would let the camera app use more native and high quality functionality.\n\nAdditionally, it’s wayyy too easy to send things to the wrong person. You can’t remove people from “recently contacted” or “frequently contacted” prompts around iOS for sharing. I’m terrified I will send my girlfriends brother something immodest because his name shows above hers even though our chat volumes are way different.\n\nWhatsApp is a globally loved tool but has some pretty strange UX issues given its financial backer and experienced staff. I will continue to use it as most of the world doesn’t have iMessage; but if they did; I don’t think I’d miss the WhatsApp app that much."
                    "id": "8417060085",
                    "rating": "4",
                    "datetime": "2022-03-03T21:26:03Z",
                    "title": "Bluetooth/Airpod mic update suggestion",
                    "reviewer": "jprc1029384756",
                    "text": "I would like to humbly suggest an update in the name of users who use Bluetooth AirPods. The microphones on these devices are terrible for recording voice memos. People never understand what I say. It would be good if it were like Instagram. On Instagram, when you record a voice message it utilizes the iPhone mic instead of the AirPod mic even when using the AirPods. When I am having a conversation with someone via voice memos on WhatsApp, I have to turn off Bluetooth, then record my voice memo. After I’m done recording I have to turn Bluetooth back on. It goes on and off indefinitely until I am done with my conversation. So with that it would be awesome if we had the option to turn off the Bluetooth/AirPod mic only in a setting or just update it to be like Instagram where it records on the iPhones mic and only plays back on the AirPods. \n\nThank you so much!!"
                    "id": "1848969040",
                    "rating": "3",
                    "datetime": "2017-10-14T19:29:19Z",
                    "title": "Plenty of room for improvement",
                    "reviewer": "Doug tge CEO",
                    "text": "As an  avid user of social internet media , I found WhatsApp is lacking in many convenient features offered in other apps.  I use Facebook when I want to express some thoughts, events etc. But FB Messenger is not efficient in quick text, so I still resort to 20 years old practice in text msg like in Nokia phones. WhatsApp is subservient to the features offered by WeChat.  Understood that WeChat is by Tencent in China, nevertheless the features are amazing. The Moment posting functions are like Facebook  post. The conversation wether individual or in chat groups are more user friendly than WhatsApp. It allows recalling a wrong message sent in mistake. Attaching files and emojis are awesome. My only complain is that once viewed in one device the message cannot be reviewed in an other, which FB allows all history conversation once logged in. \n\nI lived in America over 47 years. I highly recommend friends to use WeChat for daily contacts over other apps."
            "totals": {
                "average_rating": "4.7",
                "review_count": 10556520,
                "stars_count": {
                    "5_stars": 8867476,
                    "4_stars": 844521,
                    "3_stars": 316695,
                    "2_stars": 105565,
                    "1_stars": 316695

Frequently asked questions:

  • How do I get all the reviews for a single place?
  • You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.