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 866450515
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=866450515&auth_token=XXXXX&offset=0

Example response:

        {
            "reviews": [
                {
                    "id": "4141842634",
                    "rating": "5",
                    "datetime": "2019-05-13T02:08:11Z",
                    "title": "Forest is my new favorite app",
                    "reviewer": "Jo_Wiley_49",
                    "text": "I’ll be honest: I’m a student, and I spend WAY TOO MUCH time on my phone. It is a major distraction and I can feel myself getting sucked in but was having trouble ever convincing myself to just put it down and get stuff done. I never buy apps (I only go for the free versions of everything) — I literally just paid actual money for my first app ever earlier this year, after owning a smart phone for the past 6 years. This app is well worth the $2. It helps motivate me to stay off my phone when I’m practicing (music student) or trying to get work done. My boyfriend also has the app and we’ve made rooms to help us both focus simultaneously a few times but I’m hoping to get more friends to buy it so I can do this more. It is the perfect combination of motivating and making you feel disappointed in yourself if you slip up 😂 Seriously, it’s so satisfying to watch your forest grow and it’s very easy to use. You can also create new “tags” for why the trees were planted, which I love (I made one specific for practicing which is also a good way to help me keep track of how much practice I do). I had tried setting time limits for screen time/social media through iPhone settings but I’ve already started ignoring that....but Forest is so much more convincing and I just can’t let my sweet little trees die lol. Overall I love love this app and wish I’d heard of it sooner! It’s a relief to have something really hold me accountable for my screen time!"
                },
                {
                    "id": "3781613433",
                    "rating": "5",
                    "datetime": "2019-02-17T18:00:22Z",
                    "title": "Honestly a game-changer",
                    "reviewer": "KezOnDemand",
                    "text": "Don’t get me wrong, my phone is a useful tool, and I wouldn’t necessarily say I’m addicted to it. However, it’s also a super easy way to waste time you don’t even realize you could be using on other things. I use Forest mostly in small increments, and it keeps me from picking up my phone whenever I have a few free minutes and get bored. Since I don’t actually need or want to be on my phone, the small motivation of growing little bushes and trees is enough for me to direct my attention elsewhere- and it turns out that those few free minutes throughout the day can translate into a lot of extra productivity!\n\nOtherwise: initial download price might seem a bit high, but considering that they plant real trees if you make enough coins to buy the option, the $2 is warranted. Coin prices in the app are average, but payment per tree during the week is okay and you can make enough yourself with a little effort (I personally think you should make a little more per tree than they offer, but it’s not a bad amount either). The interface is simple and intuitive, the art is charming and stylistically uniform, and my favorite part- the white noise options- are incredibly helpful for studying and neither overly expensive or so complicated that they become distracting.\n\nAll in all, great app that I use frequently. $2 has never bought me so much extra productivity."
                },
                {
                    "id": "6771977141",
                    "rating": "5",
                    "datetime": "2020-12-19T22:44:55Z",
                    "title": "Great for studying",
                    "reviewer": "Disarray Human Being",
                    "text": "Honestly, I’m the type of person who just suddenly goes on my phone or laptop in the middle of doing homework, projects, etc. It’s especially been a problem since this new school year started. This app has helped me quite a lot, though sometimes I forget to plant a tree before I begin completing assignments. It’s helped with decreasing the amount of time I spend on schoolwork, and makes me feel like I’m doing so much more. Whenever I do reach over to my phone and am about to do something besides studying, like scrolling through Instagram, I’d open it and see the tree on my screen. Then, I’d ask myself, “Do I really want the tree to die?” I’d say no. In the beginning of using this app, I was always close to using my phone while the tree is growing. I began to develop a mentality after a few days that I should finish my homework before going on my phone and do other things. Of course, I sometimes still do it when I don’t use Forest, but I feel as if I’ve lessened the amount. This is the first productivity app I’ve used, and I’ve always seen people recommend it. It’s definitely an app worth the money. You can use it on your laptop or computer as well, as a Chrome extension (which is what I started out with). It’s simple to use, and has a minimalistic aesthetic that I really enjoy. Overall, it’s a great app."
                },
                {
                    "id": "4026814839",
                    "rating": "5",
                    "datetime": "2019-04-18T04:54:51Z",
                    "title": "Amazing App, I Highly Recommend It",
                    "reviewer": "Boedinator",
                    "text": "I have been slacking off and pushing off a lot of responsibilities lately and recently I heard a student in one of my classes mention this app and how you can grow little trees and a forest and I thought that was amazing, the second I got home I checked out the app and decided to buy it, one of the best $2 I have ever spent, I’m staying way more productive lately and I love seeing the little trees get planted, it has great graphics and design and is really simple to use. When I saw there was also an option in the app to plant real trees to help the environment I thought that was absolutely amazing and made me feel really happy for getting the app and supporting the developers. I have also just recently purchased the other app by the same developers called SleepTown and it is also amazing, it has been helping me have better sleeping habits and I have been way more productive and active during the day and just feel over all happier and healthier and feel like I’m getting my life back on track. I would recommend both of these apps to everyone, I have been telling my family and friends about it a lot and how it’s helped me and they love it too. Over all 10/10 great apps, I hope to see more from the developers in the future and love what they have done to help others 😎👍 🌲🌳🌴🌵🌱🎋🎄🍀 😴👍🌖🏠🏡🏘🏰🏕🏛🏫🏤"
                },
                {
                    "id": "7030138891",
                    "rating": "5",
                    "datetime": "2021-02-23T19:31:01Z",
                    "title": "Totally Worth the Money",
                    "reviewer": "AmyR1101",
                    "text": "This is the app that’s got me through middle school and two years of high school. I don’t have a diagnosed focusing disorder, but I get writing blocks and procrastinate a lot. Like, a LOT. This app has helped me so, so much. It’s really got everything you could ask for. An amazing user interface, currency that you get  from focusing, fake (and real) trees that you can plant to make a beautiful forest out of focusing, tags so you know where you’re spending time focusing, and really cool analysis tools that show you what days and what times you focus the most. This is the one of the only apps that I would say is completely worth your money. The tech team is really amazing, I reached out to them about an issue I had and within a day they responded and within a week had fixed the issue. I’ve also for years been pushing for a stopwatch feature in their feedback survey(as a student I don’t always know how long homework will take) and they listened! The only things I guess I would say could be better would be the leaderboard, since it’s worldwide and there are some people who use the app to just get away from their phone, so they can have seriously high hours and it’s really impossible to beat if you use Forest for studying. Overall, amazing app that has literally changed my life in a positive way."
                },
                {
                    "id": "4120945921",
                    "rating": "5",
                    "datetime": "2019-05-08T22:58:45Z",
                    "title": "Great app",
                    "reviewer": "Peace4KT",
                    "text": "I love this that it helps me stay focused and I can get enough of it you get trees and depending on how long your focus for depends how many coins you get because every 20 minutes you get seven points but anything like 25 minutes or how are you hat you can plant a tree anything lower than 25 minutes is a bush and any cool events you get cool trees the best part is is that you can’t buy anything but you can’t pay for coins you can’t cheat so the only way to get coins is you have to play the app for a while and it’s not technically a gameTechnically it’s not a game but such a cool thing to have if you’re having trouble staying focused like me I would totally recommend this app but anyone who is looking for a game to play don’t take this up but if your having a little bit of trouble I suggest taking a try at it it will be deafly worth the while of two box rather than going for the cheaper version the free one which was Flor at no offense but the only way you can login is my Facebook but this one is much more accurate and definitely the more original version I would’ve definitely done this if this was definitely free but it still worth two dollars you pay at the very beginning I would totally go for this app if you are really need some help focusing."
                },
                {
                    "id": "3070672819",
                    "rating": "5",
                    "datetime": "2018-08-16T04:10:21Z",
                    "title": "Easy, motivating, effective",
                    "reviewer": "ijustgetbored",
                    "text": "I downloaded the app for work productivity, but it’s made me hyper-aware of how often I actually pick up my phone. For any task, just having the reminder that my phone is not currently available to me is extremely helpful. I’m realizing that I waste a ton of time that stems from, say, just looking at a text that could wait until later. Moral: don’t think this app isn’t useful because you’re not at a desk all day. It has countless uses. \n\nI agree with what other users have said about gamification being a good motivator, and the user interface is very appealing. Creating and naming tags produces helpful data. For instance, if you’re concerned about work-life balance, you can see a colorful pie chart with a few simple clicks. \n\nOne thing: I’m fine with how the trees become more “expensive” as time passes. However, it can take a long, long time to gain sufficient coins after awhile. I’m not asking for instant and easy gratification, because that’s contrary to the spirit of the app. I think adding more achievement bonuses (that don’t depend on having friends that use the app or on leaderboard performance) would be great. Unlocking achievements is also rewarding and something to strive for, so I’d love to see more!",
                    "reply": {
                        "text": "Hello,\n\nThank you for your feedback. \nWe will forward your suggestions to our team.\n\nFeel free to contact us via our in-app feedback system if you have further questions. :) - Forest"
                    }
                },
                {
                    "id": "7195072166",
                    "rating": "5",
                    "datetime": "2021-04-07T17:42:20Z",
                    "title": "100% RECOMMEND!!!",
                    "reviewer": "Alired22",
                    "text": "If you are on the fence about buying this app, take this as a sign to purchase and download it. This app is so fun and motivating. I have tried other methods like the Pomodoro technique, but it doesn’t seem to work. However, as someone who sometimes has trouble staying focused and getting things done, this app is helpful than one may realize. I love plants so this app is definitely for me. I get excited once I have planted things in my forest and sometimes don’t even feel like I am working because I am motivated to make my plants and forest grow. And I am disappointed when one of my plants die. Maybe it is just me but I also love how I am encouraged by receiving coins, which I can use to buy different types of other beautiful plants of my choice (which just motivates me even more). I love the aesthetic of the app and don’t know where I would be without this app. I spend A LOT of time on my phone, so the Deep Focus setting that kills my plant if I exit the Forest app is amazing. Because I hate seeing my plants die. I hold my forest in my heart and love watching it get bigger and bigger. The app is the best. It helps me get my work done while keep it stress free, light and fun."
                },
                {
                    "id": "2582608095",
                    "rating": "5",
                    "datetime": "2018-05-22T21:33:32Z",
                    "title": "This is the only app I’ve ever truly loved",
                    "reviewer": "mollielarue",
                    "text": "I’ve never reviewed an app before, but I love this app so much. I downloaded it after my previous pomodoro timer app, tide, stopped timing correctly, which was literally all it had to do. The timer on this app works, with reliable notifications, and the “gamification” of being focused may seem silly, but it adds a cute and fun element to using a pomodoro timer. Also, the ability to tag how I spend my time (ex: work vs all other things) is an easy way to stay balanced. For instance, I can see if I’m falling behind on daily meditating even if it’s something I’m not conscious of. I can also see someone using this app not necessarily to boost concentration but as a way to literally bar yourself from using your phone for periods of time when you need to be present (ex: during a meeting or with a friend). One more thing I love: I just finished a project that took two months, and I went back and looked at my little forests for that time. Each lil tree helped me get that project done. It’s such a beautiful reminder that everything big happens with many tiny steps!"
                },
                {
                    "id": "3369609280",
                    "rating": "5",
                    "datetime": "2018-11-01T19:28:12Z",
                    "title": "Adorably Motivational",
                    "reviewer": "LanthanaTitanium",
                    "text": "The cute little trees are just so adorable that I start wanting to put down my phone so I can unlock new ones! I am eagerly awaiting new trees to be added. The user interface is very simple and aesthetic. All in all it’s a great app; the only problem is that sometimes I run into situations where I plant a tree but then end up needing to use my phone for something (like if my mom calls or I have to look up something for homework) and can’t wait for the tree to finish. There is a feature where you can have the app continue counting time after the tree finshes growing, so you can work around the problem by planting a short-time tree and then just continuing to not disturb it. But it would be really great if there was some sort of pause feature, maybe with some limitation like not earning coins if you pause it so that people don’t take advantage of it to ‘cheat’ on their time. Or maybe something where you can erase or reset the time, so you don’t have to feel bad about killing a cute little tree when you actually legitimately needed to use your phone for a minute.",
                    "reply": {
                        "text": "Hello,\n\nThank you for your feedback. \nWe will forward your suggestions to our team.\n\nFeel free to contact us via our in-app\nfeedback system if you have further questions. :) - Forest"
                    }
                }
            ],
            "totals": {
                "average_rating": "4.8"
            }
        }
    

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.