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 https://wextractor.com/api/v1/reviews/appstore 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 https://apps.apple.com/us/app/whatsapp-messenger/id310633997 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:

https://wextractor.com/api/v1/reviews/appstore?id=310633997&auth_token=XXXXX&offset=0

Example response:

      {
        "reviews": [
            {
                "id": "2452232102",
                "rating": "5",
                "datetime": "2018-04-22T03:34:03Z",
                "title": "Complaining",
                "reviewer": "dieguito_27",
                "text": "Ok so I generally love the app. But with the new update came something peculiar about the voice message. Now you can keep listening to the voice even if you turned off the phone or switched to another app, but the catch is that if you’re listening to music and you start to listen to a voice the music doesn’t start automatically after you’re done listening to the voice. Now you have to enter the music app and press play so you can keep listening to the song. I don’t really like that. Another thing I don’t like is that if you take out the read receipts you can’t see if someone saw your status. And that’s really frustrating because you took out the read receipts so no one in the CHATS could see if you saw their text. Not for the status. I would really appreciate it if you took out those two things. Please and thank you!"
            },
            {
                "id": "5913215823",
                "rating": "4",
                "datetime": "2020-05-07T04:38:41Z",
                "title": "Stickers changed everything",
                "reviewer": "torresale3",
                "text": "So my friends and I have debated back and forth whether if to use whatsapp or imessage as our primary way of communicating for as long as I can remember. In all honesty we frequently switched back and forth. However, ever since whatsapp released stickers, there is no debate. My whole entire city/everyone I know constantly trades stickers like pokemon cards & it makes our conversations 10 times funnier. We also create our own stickers using other apps. Our biggest request is to please allow us to organize our stickers (maybe by sorting them into folders/tabs) because we have so many and they get lost in the bunch. Another great idea would be to have access to create new stickers directly through whatsapp instead of a third party application. Please take these things into consideration. I never write reviews but we’ve all genuinely said it for months that we wish we could organize our stickers."
            },
            {
                "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": "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": "4992553432",
                "rating": "5",
                "datetime": "2019-10-21T12:46:13Z",
                "title": "A comprehensive review of Whatsapp security.",
                "reviewer": "amr bashq",
                "text": "First of all yes I am on addersal. WhatsApp has a number of advanced security features. It has end-to-end encryption, just like Apple’s iMessage and Signal. All messages flowing through the platform are secured so that only the sender and the recipient can view them. WhatsApp couldn’t read your message even if it wanted to. The app doesn’t store your personal information, and only people you approve as contacts can message you. As with an increasing number of internet services like Google and Facebook, WhatsApp uses two-factor authentication, which has you type in a second passcode sent to your phone via text message to access your account. Group messages can conflict with some privacy settings, however, in that if you have blocked someone, they can still appear in a group message that you can see"
            },
            {
                "id": "1930841789",
                "rating": "5",
                "datetime": "2017-11-18T20:58:14Z",
                "title": "Incredible",
                "reviewer": "Nin★DogeAppReviews",
                "text": "I really love this app. It's incredible how you can talk with anyone around the world without paying actual money. There’s nothing wrong happening with my version, the camera works well and shoots good photos. There are some things that would make this app the best messaging app. The first one is that when you mute a group chat there should be an option that allows you to mute it forever, same goes with the real-time location. When you create a group, others shouldn’t have the option to kick you from the group, and there should be an option to make someone not be an admin without having to kick the person and adding them again. Also, I really want the GIFs to have their own spot so you don’t need to go to Photos and Videos and then click GIFs. Also, make a DRAWING option. Well, that’s all. Thanks for this amazing app."
            },
            {
                "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": "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."
            },
            {
                "id": "2512999808",
                "rating": "4",
                "datetime": "2018-05-06T18:08:59Z",
                "title": "Too easy to call people by accident",
                "reviewer": "Adriana04",
                "text": "The app is really great and connects me with my contacts all over the world. It makes it easy to stay in touch. You can text and even call for free. Doesn’t get any better than that!\nThe only thing I would change is how easy it is to call people by accident. It happens all the time. I wish they would hide that button behind the profile page. This is mostly a texting app, do we really need that button on the first page?Even on an iPhone you have to first click the i button from the message page to call someone. It’s smart. \nAnother issue is that the app distorts the quality of pics and videos after they are sent. I often receive videos with delayed sound and fuzzy images. I have to ask my contacts to send me those through other apps so I can actually get the proper sound. \nPlease fix and it will be the most perfect app!"
            },
            {
                "id": "4275597710",
                "rating": "5",
                "datetime": "2019-06-07T03:16:35Z",
                "title": "Just a minor issue that’s really problematic",
                "reviewer": "Jreome J.",
                "text": "Sometimes my messages can’t go through on time and it’s takes forever for them to receive it. When I text my friends who own Samsung devices, the message won’t go through even though they’re still online. It usually takes about 3 to 2 minutes for the other person to read my message(s). What really bugs me is that once it shows *last seen today at (time)* the message that I’ve sent is delivered, and it’s would show the double check mark. So the person who I sent a message to would only get it if they exit out the app. Plus, no matter how much messages you send to that person, they will never receive it until they exit out of WhatsApp.\n\nPlease fix this issue🙏🏼. It makes it really hard to communicate, even when it’s an emergency."
            }
        ],
        "totals": {
            "average_rating": "4.7"
        }
    }
    

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.