Yelp 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 Yelp API returns 20 reviews per request.
  • The default order in which reviews are returned is by descending date(from newest to oldest).
  • You can get all reviews from a single place by using the offset parameter.

To get reviews from Wextractor you will need to perform GET requests against the https://wextractor.com/api/v1/reviews/yelp 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 a place in Yelp. This identifier is the last component of the path of the url for the place in Yelp. For example, if the url for the place in Yelp is https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york then the id is best-buy-midtown-manhattan-44th-and-5th-new-york best-buy-midtown-manhattan-44th-and-5th-new-york
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, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.). 20
sort Optional This parameter defines in which order the results will be returned. If no value is passed, the results will be ordered by descending date. The possible values for this setting are:
  • recency (default): return newest reviews first.
  • relevancy: return the most relevant reviews first. They are usually higher quality reviews.
  • highest_rating: return the reviews with higher ratings first.
  • lowest_rating: return the reviews with lower ratings first.
recency

Example usage:

https://wextractor.com/api/v1/reviews/yelp?id=best-buy-midtown-manhattan-44th-and-5th-new-york&auth_token=XXXXX&offset=0

Example response:

    {
    "reviews": [
        {
            "reviewer": "Aaron S.",
            "datetime": "2019-10-13T00:00:00Z",
            "rating": "3",
            "text": "My first time in a Best Buy store as it isn't a brand I'm too familiar with as their main market presence seems to be in the US and Canada - this branch on 44th and 5th seems to be a fairly decent size - they have staff at the front of the store to greet you who seemed really friendly, sadly the rest of the staff who wore a different coloured uniform didn't follow that high standard who seemed to be getting in the way more than anything, and a little rude. I liked how they had a small Apple section with some of the latest iPhones which is useful if you don't fancy walking down 5th Avenue to one of the world's largest Apple stores - the selection is ample if you're looking to take a browse, rather than being more of an Apple nerd. The pricing was reasonable but I certainly wouldn't describe their products as the \"Best Buy\" either. I would have liked to see a greater selection of more high-end electronics including laptops, especially gaming laptops but this is a pretty decent store. 3*",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=Wb71clj3vTZr4QOyOYglJA",
            "id": "Wb71clj3vTZr4QOyOYglJA"
        },
        {
            "reviewer": "Arier M.",
            "datetime": "2019-10-08T00:00:00Z",
            "rating": "1",
            "text": "Went in for a case on my iPhone 7plus with built in charger.  Asked for help to locate one. Salesperson pulls one off the rack; hands it to me, says it is compatible for my phone; remarks it's even on sale for $55. What a good deal. No. Get to check out counter and it scans in for $110 with tax.  They tell me then they can let it go for $79 which is a price match guarantee but cannot give me the sale price because the sale is for an iPhone 7 or 8 but not a 7 plus.  What kind of crap is this??  Even the manager throws her hands up and is like ohwell!!  Sorry!   Do not shop here. If u must, make sure u go online first to make sure whatever \"Sale\" they have matches it at checkout.  I've been in retail my whole life; that's not how u operate a store.  You mess up, u mess up; honor the price.  Your associate even handed it to me and told me the price!!!",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=9eye63VJl4rpsCDXQmk4_Q",
            "id": "9eye63VJl4rpsCDXQmk4_Q"
        },
        {
            "reviewer": "Dean M.",
            "datetime": "2019-10-04T00:00:00Z",
            "rating": "2",
            "text": "The customer service staff and checkout cashiers are nice. The In-store pickup system is a disorganized mess. The floor staff doesn't know anything about the product or what they carry, they literally use   as a consumer would. I worked at best buy about 16 years ago, back when they hired Teenangers who were excited for a starter job that allowed them to share their passion about technology. Now they hire people in their mid 20s-30s who are only there for a paycheck. While they are better trained than the joke the store became and was about 5 years ago. However, no amount of training can teach passion.  The store continues to engage in the illegal activity of stopping you to check receipts when you try to leave the store. Shopkeepers rights only applies to suspected shoplifters, you can not treat every customer as a suspected shoplifter, NY consumer affairs just doesn't care.  At least this location doesn't have the alternative energy hucksters trying to scam you.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=2aCBUnoZ_0J7SjozTNTALA",
            "id": "2aCBUnoZ_0J7SjozTNTALA"
        },
        {
            "reviewer": "Gilson R.",
            "datetime": "2019-09-04T00:00:00Z",
            "rating": "3",
            "text": "Not so big as B&H but the Brazilian guy who help us to buy few things was the difference. The prices are similar to B&H.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=fdHe9AXia9Jf1LLkp1Gh1w",
            "id": "fdHe9AXia9Jf1LLkp1Gh1w"
        },
        {
            "reviewer": "Arnie R.",
            "datetime": "2019-05-21T00:00:00Z",
            "rating": "5",
            "text": "This is a follow up on my review about the Best Buy on 62nd and Broadway. Since the people at 62nd and Broadway were NOT helpful in any way, I came to the Best Buy on 5th Ave. WHAT. A. DIFFERENCE!!  Everyone was SO kind, helpful, calm, and not caddy at all. They helped me with everything dealing with that terrible Lenovo Yoga 730 laptop. (Reminder: do NOT buy that laptop)  Thank you Nicari and Jalil at Geek Squad.  You two were INCREDIBLY helpful and you MUST be acknowledged for that.  So if you want a better experience with this store...  AVOID Best Buy on 62nd and Broadway  DO GO to the Best Buy on 5th Ave.  Happy (Best)Buying!",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=RhiLGomckGQ5vnmoBUsx8Q",
            "id": "RhiLGomckGQ5vnmoBUsx8Q"
        },
        {
            "reviewer": "Anna H.",
            "datetime": "2018-01-19T00:00:00Z",
            "rating": "5",
            "text": "Exactly when the doors opened at 9:00 am, I walked around the corner from my building to Best Buy: Geek Squad. Nowadays you should schedule an appointment online or the wait time is unbearably long. It was going to be 40 mins for me to wait for a Geek Squad representative but the customer service representative was able to squeeze me in at 9:40 am. I waited till it was finally my turn and Regina Barresi assisted me with my emergency. I handed her my Geek Squad Renewal information because I like to be prepared so they know about my insurance coverage and laptop model information. I explained the issue that my laptop cracked as I pushed back and forth the screen when I am watching my tv shows and YouTube videos. Regina checked out my laptop up close and it definitely needs to be sent out. She informed me that it would take about 2-4 weeks ::sad face::  I recommended having my laptop shipped back to the Best Buy in Skyview Center because it's the closest location to me.  Thanks Regina for providing amazing customer service. Can't wait to hug my laptop =)",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=RtppBkUpRc1c3V-fEhlDnw",
            "id": "RtppBkUpRc1c3V-fEhlDnw"
        },
        {
            "reviewer": "Dee O.",
            "datetime": "2019-09-14T00:00:00Z",
            "rating": "1",
            "text": "Personnel seemed like they couldn't be bothered assisting me or any person of color. However, they were very energized and descriptive when assisting white (male) shoppers with product information. I went in for a new phone and wireless earbuds. I left with nothing, not even advice. Terrible customer service.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=VZk1zhrc028Tu8t1omGsBw",
            "id": "VZk1zhrc028Tu8t1omGsBw"
        },
        {
            "reviewer": "Kevin A.",
            "datetime": "2019-06-22T00:00:00Z",
            "rating": "1",
            "text": "This review should be a zero for their IDIOT Employees allowing a $4,000 purchase on an unauthorized opening of a credit card from someone that lives 800 miles away.To the Store Manager: YOUR FIRED .You and your staff are a complete disgrace.I hope you all get what you deserve,A quick trip to the Unemployment Line.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=hIIy1xs-jvpC9j1-HVLu8w",
            "id": "hIIy1xs-jvpC9j1-HVLu8w"
        },
        {
            "reviewer": "Allie K.",
            "datetime": "2018-12-28T00:00:00Z",
            "rating": "1",
            "text": "Roamed around the laptop section for 15 minutes. Asked one blue shirt if he had time to assist me. He blinked a few times then said yes. Offered zero actual insight on the laptop options then sent me around the corner to look at a model. Never saw him again. Approached a different blue shirt, moderately more helpful, but kept trying to sell me a $700 laptop I didn't want. Ended up going with the 'cheaper' $350 model. It sucked - immediately knew I wanted to return it. Issues when trying to return it, of course. I feel bad for anyone who's not tech-savvy and goes in there cause they'll probably be duped into over-spending on a bad model. Shopping Amazon from now on.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=nUE3AsPoB-94dIT-o6xUrw",
            "id": "nUE3AsPoB-94dIT-o6xUrw"
        },
        {
            "reviewer": "Ken P.",
            "datetime": "2018-11-20T00:00:00Z",
            "rating": "3",
            "text": "To me a Best Buy is a Best Buy is a Best Buy.  Depending on my needs at the time and my location in my metropolis is when I might drop in here.  The last time I was in this location was when I was meeting friends for dinner nearby and I needed the \"Deadpool 2\" Blu-ray :)  So essentially I went in and picked up the video and left.  Easy as pie.  One thing I noticed about any BB location is that its a crapshoot on whether or not a staff person knows what is there or where something else might be.  Granted a video person would not know the appliance section but they should have the mindset in keeping the customer there instead of finding them discouraged or annoyed and leaving without any kind of purchase.  Overall this is an okay spot when I need something, if I am right there.  Otherwise I generally go to the one on 14th Street in Union Square.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=WHiLbpGlVDdFOe3cDlz5iQ",
            "id": "WHiLbpGlVDdFOe3cDlz5iQ"
        },
        {
            "reviewer": "Sharon R.",
            "datetime": "2019-08-07T00:00:00Z",
            "rating": "1",
            "text": "This is one of the worst businesses I've ever dealt with.  We bought a new HP laser jet from them several months ago, along w a geek squad contract.  We have spent many hours on the phone with geek squad and they a a bunch of idiots.  They also came to the house twice.They couldn't fix anything.  Finally they sent us to HP.  We thought they would send us a new printer, based on our contract, but then we had to spend almost 2 hrs on the phone with them.  They did get it working but not for long.  Now I will waste more time talking w these HP idiots.  Extremely frustrating.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=vNJAy_7m9JQsIMDI1OCdfQ",
            "id": "vNJAy_7m9JQsIMDI1OCdfQ"
        },
        {
            "reviewer": "Mark Nowell M.",
            "datetime": "2018-09-28T00:00:00Z",
            "rating": "1",
            "text": "Worst best buy but all best buy are bad anyways! I am looking for phone stabilizer and the first guy that I asked said that he does not know and asked me to go to the phone department. The guy in the phone department told me that he does not work on the phone department. Like wth? So who should I ask? Nobody on the entire store?! I got annoyed and left.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=uO1GukoSPlYIPiOAcskh2w",
            "id": "uO1GukoSPlYIPiOAcskh2w"
        },
        {
            "reviewer": "Chao X.",
            "datetime": "2018-02-06T00:00:00Z",
            "rating": "1",
            "text": "Extreme rude customer service at the Geek Square (or really \"Jerk\" Square) I booked an appointment via Apple to check upon a TouchID issue on my phone. The lady asked me what iPhone I had, to which I replied \"iPhone 6 plus\". She then went to the back to talk to her supervisor... to my utter surprise, they were laughing so loud and condescendingly about me even having an \"iPhone 6 plus\" at this day and age... I mean seriously?! excuse me,  I can hear you!!! Then the lady came back and told me rather snobbishly that they don't repair iPhone 6 Plus anymore and the only thing they could do is to replace the screen with iPhone 6 Plus Plus (what?!). At this point I was thinking to myself  \"did you even look at my phone to see if it's a hardware problem?!\". I left feeling rather angry. Never coming back! This is the lowest raring I've ever given on yelp and I think this store deserves it.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=x6SAYJzN_0OuN1vhSI1qMA",
            "id": "x6SAYJzN_0OuN1vhSI1qMA"
        },
        {
            "reviewer": "Sam S.",
            "datetime": "2019-06-14T00:00:00Z",
            "rating": "2",
            "text": "I went in to Best Buy after Apple had made me a reservation. I walked in and waited around 5 minutes for someone to help me. They directed me to the back of the store where I met Justin, a member of the Geek Squad. He was blunt, unwelcoming and had a hard time communicating. I started joking around and finally got him and his colleague to start laughing and loosen up a little. He then started to take my details and asked for the same thing over and over rather than just copy and pasting. When I asked for information his responses were short and uninformative. I often had to ask follow up questions. The repair took an hour. Exactly what they had told me. The repair wasn't perfect. He did take it to the back and again and came back 30 secs later unable to have done anything. Told me that was the best he could do and asked me to sign a form confirming I was happy with the installation. I shouldn't have signed it honestly. Poor poor poor customer service. Decent service but Apply should find another third party to use. Not so pleasant.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=jOTUrHmyTqbg55K4adSv6A",
            "id": "jOTUrHmyTqbg55K4adSv6A"
        },
        {
            "reviewer": "Wolfee W.",
            "datetime": "2018-08-10T00:00:00Z",
            "rating": "1",
            "text": "So I go in at 5:38pm today. Go to the phone area. There maybe 4 people looking at phones, 1 person is helping a customer. I know whay I want and he tells me he will have someone help out. He goes over to the 7 people near the phones ans registers who are just standing around not doing anything. I see them talk and he then gets a hug from a friend. And walks off. Stand there thinking someone would walk over. Nope no one at all. They stand in the same spots not giving a Damn. About customers or helping people.  So I walked out after waiting 10 mins for np service.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=SU3VZU1eBRLLxjYuwUtWwg",
            "id": "SU3VZU1eBRLLxjYuwUtWwg"
        },
        {
            "reviewer": "Cara M.",
            "datetime": "2019-02-22T00:00:00Z",
            "rating": "5",
            "text": "I have been in several of the Best Buys in NYC, and this one struck me for having the most helpful staff. I know sometimes an area is understaffed, but wow, this store had a lot of people and the staff in the TV area was knowledgeable, as was the staff in the Computer section. That's what I was there to do, research computers as my old one was crapping out on me. Many thanks to Osiris for his patience and low pressure approach, and the same to the guy from Microsoft. I bought a new laptop and I'm very happy with service received at this location, if you couldn't tell.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=o70-RShnOks4dCAhGiAsKg",
            "id": "o70-RShnOks4dCAhGiAsKg"
        },
        {
            "reviewer": "Kim S.",
            "datetime": "2017-02-07T00:00:00Z",
            "rating": "2",
            "text": "I was in NYC for my birthday. I knew that I wanted the amazon echo dot so we stopped in the get it. I ask a sales person to point me in the direction of the Amazon products. He leads us there and then tells me that I need to get the amazon echo to accompany the amazon echo dot. I tell him that I DO NOT NEED to get the  $179 product when all I want is the $49 product. He then tells me that it will not work without the other product. I say, \"ok\" and walk to the register. I was beyond annoyed that he was trying to UP SELL a product to me - a techy girl. I have researched this product and knew exactly what I was getting and what I wanted. I went to the hotel, set up Alexa and it worked perfectly!",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=yulQreYJMudZLAiOe3X1gw",
            "id": "yulQreYJMudZLAiOe3X1gw"
        },
        {
            "reviewer": "Jaime F.",
            "datetime": "2018-12-23T00:00:00Z",
            "rating": "1",
            "text": "There are like 10 dudes in blue shirts in the laptop section and none of them helped me or acknowledged me for like a half hour. Then I just left. Use your eyes people! Neglecting ur customers is a bad look. Best buy? Worst service.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=W5LKLtecVcfM1gSapB86tg",
            "id": "W5LKLtecVcfM1gSapB86tg"
        },
        {
            "reviewer": "Lindsay S.",
            "datetime": "2018-03-28T00:00:00Z",
            "rating": "3",
            "text": "I'm only giving this place three stars because the young woman in the camera section was so helpful that I waited awhile for her to be free again in order to get credit for the sale. The second she walked away while I was mulling over my decision, no less than five obnoxious and creepy male employees weren't leaving me alone - I literally had to tell the manager to get away from me. One young, white male there thought it was appropriate to call me \"sweetie,\" and it was immediately revolting. I almost didn't make my purchase because the male camera employees were so awful, but the woman who assisted me - Novella - was a pleasure. She was kind, real, and knowledgeable, and I appreciated her approach. In the end I bought a camera and some accessories but only from her, as her associates belong in the retail Hall of Shame.",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=fX8V2IoJ2pDWCTtUP7O-RQ",
            "id": "fX8V2IoJ2pDWCTtUP7O-RQ"
        },
        {
            "reviewer": "Visual T C.",
            "datetime": "2018-11-19T00:00:00Z",
            "rating": "1",
            "text": "I brought a HP Computer in July 2018 from this Best Buy and they sold me a lemon. Didn't work correctly from the beginning, November sent computer to HP for repairs. The computer ran slow, mouse didn't work neither did touchpad. HP didn't standby warranty! So Best Buy and HP rip me off! $500.00 they stole from me!",
            "language": "en",
            "url": "https://www.yelp.com/biz/best-buy-midtown-manhattan-44th-and-5th-new-york?hrid=Pso6gHBF3SYzYxv-s0BxfQ",
            "id": "Pso6gHBF3SYzYxv-s0BxfQ"
        }
    ]
}
    

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.

  • Does the API have rate limits?
  • Yes, since Yelp is pretty strict at blocking requests you will be rate limited if you perform more than one request per second.