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 10 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, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.). 10
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
language Optional Return reviews that were done in the given language as defined by ISO_639-1 en

Example usage:

https://wextractor.com/api/v1/reviews/yelp?id=foodee-burger-san-francisco&auth_token=XXXXX&offset=0

Example response:

        {
            "reviews": [
                {
                    "text": "This is the best tasting spicy chicken sandwich in town. I have never had the patience to wait in line, since I am close enough for Post Mates I pay a little extra to get it delivered. I would rather was a little more money to not be inconvenienced by the line and parking situation. I've ordered a total of 4 times and The food makes it in good shape and still hot.",
                    "reviewer": "Adriana C.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/PRYUaJggf1aTzLR0p4fmFA/60s.jpg",
                    "datetime": "2022-08-11 00:00:00",
                    "id": "5H6YlhP9Av-lrqSBlWwuiw",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=5H6YlhP9Av-lrqSBlWwuiw",
                    "reply": null
                },
                {
                    "text": "best chicken in the city; bar none. deeply recommend.",
                    "reviewer": "Brice Mitchell W.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/NqC35RpcFXxvSbjk78fFGg/60s.jpg",
                    "datetime": "2022-08-10 00:00:00",
                    "id": "04iTWyH96770vZBobfz2Gg",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=04iTWyH96770vZBobfz2Gg",
                    "reply": null
                },
                {
                    "text": "Ugh Howlin' Ray's is always a good idea. Still my favorite hot chicken sandwich of all time. I've been eating here since it opened and I still haven't found a hot chicken place better than Howlin' Ray's. Hate to say it but the hype is very real :)",
                    "reviewer": "Sarah A.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/yn6WsYqeSuzXRSF4Ktplpg/60s.jpg",
                    "datetime": "2022-08-09 00:00:00",
                    "id": "8VWS9huhFTU34jc6_M7xZg",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=8VWS9huhFTU34jc6_M7xZg",
                    "reply": null
                },
                {
                    "text": "Worth the hype. Very flavorful. Chicken was juicy and crispy. Special sauce was delicious. Despite it being very busy the order was ready relatively quickly. Great customer service.",
                    "reviewer": "Julissa R.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/zz-3DEGRL0n2e1absiKXqQ/60s.jpg",
                    "datetime": "2022-08-09 00:00:00",
                    "id": "NqzAWEdO0TrIWYREKj1Frw",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=NqzAWEdO0TrIWYREKj1Frw",
                    "reply": null
                },
                {
                    "text": "If you want a really good fried chicken this is the place. Be ready to wait but it's worth it. Writing this review post sandwich high Eat here! You won't regret it.",
                    "reviewer": "Migran K.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/3bCTuOeSyiLu3mDpu_1Rhw/60s.jpg",
                    "datetime": "2022-08-09 00:00:00",
                    "id": "EovQMSdjEwGWU5RRhbyqRw",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=EovQMSdjEwGWU5RRhbyqRw",
                    "reply": null
                },
                {
                    "text": "I wanted my chicken to be mild and it was still super spicy.  The macaroni salad was salty and I did not like the taste of it.Sorry but i'm not sure why customers would wait two hours for this food, salty, very spicy and does not taste good.  I am not coming back.",
                    "reviewer": "Paulina A.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/rBZQgPEL_SD3dQIe-innlw/60s.jpg",
                    "datetime": "2022-08-08 00:00:00",
                    "id": "POinTcY_mrblhRhSpO3BcA",
                    "rating": "1",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=POinTcY_mrblhRhSpO3BcA",
                    "reply": {
                        "text": "Hi Paulina! We’re sorry to hear that you did not enjoy your recent order with us! Can you please share the name that the order was placed under? As well as the order date/time? We would be happy to issue you a refund for this! - Amanda",
                        "datetime": "2022-08-10 00:00:00"
                    }
                },
                {
                    "text": "I'm gonna say this once and say it loudly soeveryone can hear - this is the best spicy friedchicken sandwich you will ever have. AND thebest Cajun fries you will ever have!The sandwich is saucy and spiced to the gods,the chicken is perfectly crunchy and well-seasoned, the slaw is so creamy and flavourful- I could go on for what feels like forever.And the fries, I swear I've had dreams aboutthem. First off, they taste like real potatoeswhich is always a good sign lol they're crispy onthe outside and soft inside, with a generousdusting of Cajun spice that make theseunforgettably delicious.Just try it out for yourself and see, but I adviseyou order ahead for pickup to avoid long lines!",
                    "reviewer": "Danielle B.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/3AYscQLuhEOPnkzwCGJsxQ/60s.jpg",
                    "datetime": "2022-08-07 00:00:00",
                    "id": "NIum4ZHN6Y3WVEiz62NrZw",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=NIum4ZHN6Y3WVEiz62NrZw",
                    "reply": null
                },
                {
                    "text": "Will I come back here? Yes, this is one of my go to chicken sandwich spots Amazing spot. I got the sandwich with medium plus spice and it was amazing. Maybe I'll try medium next time but delicious. There Mario fries are also on point and a fav of my gfs. I will def come back hereThis is in the top 3 for best chicken sandwiches spots in the US. Idk which spot is #1 but Howlin Rays made a strong argument.",
                    "reviewer": "Soroosh A.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/mITRSZ6yTFaXO8ZIxlSFOw/60s.jpg",
                    "datetime": "2022-08-07 00:00:00",
                    "id": "K3wAjKDzooAo25sysDpC-Q",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=K3wAjKDzooAo25sysDpC-Q",
                    "reply": null
                },
                {
                    "text": "Everything about this place is worth it.  The food wow untouchable. Yea be ready for long lines. Iv waited about 4 hours to order but every second was worth the wait for that spice. Trust me just don't order for one meal you will hate your self if you don't get a few orders for later.",
                    "reviewer": "Rick T.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/photo/Hys2O8ey7ms5Z1cuozYdVg/60s.jpg",
                    "datetime": "2022-08-07 00:00:00",
                    "id": "Pz5SaVJy3t6JIJiYGtnoLQ",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=Pz5SaVJy3t6JIJiYGtnoLQ",
                    "reply": null
                },
                {
                    "text": "Hands down number 1 Need not say anymore Service Taste Heat Happiness Mission complete",
                    "reviewer": "Aryan K.",
                    "avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
                    "datetime": "2022-08-06 00:00:00",
                    "id": "TjJGqu1rD1V4AnBsUZk0fQ",
                    "rating": "5",
                    "language": "en",
                    "url": "https://yelp.com/biz/howlin-rays-los-angeles-3?hrid=TjJGqu1rD1V4AnBsUZk0fQ",
                    "reply": null
                }
            ],
            "totals": {
                "review_count": 9636,
                "average_rating": "4.5",
                "languages": [
                    {
                        "language": "en",
                        "review_count": 7200
                    },
                    {
                        "language": "es",
                        "review_count": 3
                    },
                    {
                        "language": "zh",
                        "review_count": 2
                    },
                    {
                        "language": "nb",
                        "review_count": 1
                    },
                    {
                        "language": "ja",
                        "review_count": 1
                    }
                ]
            }
        }
    

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.