Skip to content

Yelp Reviews API

Scrape Yelp business reviews and ratings with a simple API call

Last Updated: March 16, 2025

A GET request to our /api/getter/?platform="yelp_reviews" endpoint allows you to scrape Yelp reviews for any Yelp business ID.

New! Scrape all reviews at once with Yelp Reviews Scraper

We now offer a more convenient and reliable way to scrape Yelp reviews with the Yelp Reviews Scraper. This works better because it extracts all the reviews for a listing with a single request unlike this API which requires you to loop over the page numbers manually. It can be used via API or our No-Code application.

Example

For this example, let's scrape Yelp reviews for this lawyer's business. First we find the biz_id for listing using the Yelp Listing Details API. Then we pass the ID, zbIhAJBZZ-UXpHXvDPI51Q, to our endpoint as showcased below:

1
curl "https://data.unwrangle.com/api/getter?platform=yelp_reviews&biz_id=zbIhAJBZZ-UXpHXvDPI51Q&page=2&api_key=API_KEY"
1
2
3
4
5
import requests

url = "https://data.unwrangle.com/api/getter?platform=yelp_reviews&biz_id=zbIhAJBZZ-UXpHXvDPI51Q&page=2&api_key=API_KEY"
response = requests.get(url)
print(response.json())
1
2
3
const response = await fetch("https://data.unwrangle.com/api/getter?platform=yelp_reviews&biz_id=zbIhAJBZZ-UXpHXvDPI51Q&page=2&api_key=API_KEY")
const data = await response.json()
console.log(data)
1
2
3
4
5
6
<?php
$url = "https://data.unwrangle.com/api/getter?platform=yelp_reviews&biz_id=zbIhAJBZZ-UXpHXvDPI51Q&page=2&api_key=API_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>
1
2
3
4
5
6
require 'net/http'
require 'uri'

uri = URI.parse("https://data.unwrangle.com/api/getter?platform=yelp_reviews&biz_id=zbIhAJBZZ-UXpHXvDPI51Q&page=2&api_key=API_KEY")
response = Net::HTTP.get(uri)
puts response

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Review Query

biz_id

Required

Yelp business ID. You can find the business ID by using the Yelp Search API.

page

Optional

The page number for which you want the results. Default value is 1.

sort_by

Optional

The sorting order of the reviews. Default value is DATE_DESC. Other possible values are DATE_ASC, RATING_DESC, RATING_ASC, RELEVANCE_DESC (which is the default sorting order for Yelp).

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be yelp_reviews.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

The value of the query parameter biz_id must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.

Results

The response will include the following attributes for each review present in the response:

Attributes Returned Data Type Information Represented
id string Yelp's ID of the review
date string Date when review was published
rating int Rating by reviewer
review_title string Title of the review (if any)
review_text string Review's text content
review_url string Link to review
lang string Two letter language code for the review
review_imgs list Links to reviewer's images, if any
review_img_captions list Captions for review images
author_avatar string Link to reviewer's avatar
author_name string Reviewer's name
author_url string Reviewer's Yelp profile link
meta_data.author_contributions int Number of total reviews by author
meta_data.feedback.useful int Number of useful votes on review
meta_data.feedback.funny int Number of funny votes on review
meta_data.feedback.cool int Number of cool votes on review
location string City / State level location of the user
response dict or null Info on business' response to the reviewer

Response Example

Here's the response you can expect for the request showcased above:

{
    "success": true,
    "biz_id": "zbIhAJBZZ-UXpHXvDPI51Q",
    "url": "https://www.yelp.com/biz/samuel-geller-geller-law-san-francisco",
    "page": 1,
    "total_results": 149,
    "no_of_pages": 15,
    "result_count": 10,
    "reviews": [
        {
            "id": "cnmEidmb7B8eMBCxNiB86g",
            "date": "2025-03-03",
            "rating": 5,
            "review_title": "",
            "review_text": "I made a big mistake that ended up being over charged by a zealous district attorney. But Sam Geller was more zealous. \nSam stuck with my situation and did not let me be bulldozed into taking a deal that he felt was unfair. Ultimately my case was resolved with the best possible outcome because Sam kept fighting for what he thought was right.  \nMy appreciation and respect for his dedication to my case is genuine and heartfelt.  He is the kind of attorney that all good people deserve.\nThank you Sam.",
            "review_url": "https://www.yelp.com?hrid=cnmEidmb7B8eMBCxNiB86g",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=3T1_5QituvhplA93w2yY_A",
            "author_name": "Anna R.",
            "meta_data": {
                "author_contributions": 1,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "San Francisco, CA",
            "response": null
        },
        {
            "id": "zMYLUHq08Z2xdCqnRKPLKQ",
            "date": "2025-02-28",
            "rating": 5,
            "review_title": "",
            "review_text": "Sam helped me with a misdemeanor diversion, and made the whole process easy. I really appreciate his services and would recommend to anyone.",
            "review_url": "https://www.yelp.com?hrid=zMYLUHq08Z2xdCqnRKPLKQ",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=LV1YhonO3ZCk_hxfVeGeyA",
            "author_name": "C C.",
            "meta_data": {
                "author_contributions": 3,
                "feedback": {
                    "useful": 1,
                    "funny": 0,
                    "cool": 1
                }
            },
            "location": "Piedmont, CA",
            "response": null
        },
        {
            "id": "RKYTNNVeE2iKxGKHzFeVHQ",
            "date": "2025-02-18",
            "rating": 5,
            "review_title": "",
            "review_text": "I am so happy that I met Michael, even though I hoped I would never need a lawyer. At every stage, he has been exceedingly communicative, open, and professional. For all of his knowledge and experience about our family court matter, I am incredibly grateful. I hope you don't require legal assistance either, but if you do, give Michael a call!",
            "review_url": "https://www.yelp.com?hrid=RKYTNNVeE2iKxGKHzFeVHQ",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=sr5kzZ2KAeNMt0nmlP2IFw",
            "author_name": "Elliot C.",
            "meta_data": {
                "author_contributions": 2,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "",
            "response": null
        },
        {
            "id": "wC0SqM5PvgZMJJmwPNsITg",
            "date": "2025-02-12",
            "rating": 5,
            "review_title": "",
            "review_text": "I called Sam just after I got my first DUI. I had no experience dealing with courts or attorneys and he made everything very straight forward and simple. He gave me worst case scenarios, best case, and what was most likely to happen. Sam managed to get basically the best case in every scenario and tackled every challenge head on. He handled everything very professionally and spoke to me honestly and directly. I'd highly recommend hiring Geller Law!",
            "review_url": "https://www.yelp.com?hrid=wC0SqM5PvgZMJJmwPNsITg",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/photo/rBM0tf1L7phGEy_zjZSYYg/60s.jpg",
            "author_url": "https://www.yelp.com/user_details?userid=hfN_3KAzRGeLHZaiLvizDw",
            "author_name": "Jordan W.",
            "meta_data": {
                "author_contributions": 5,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "Costa Mesa, CA",
            "response": null
        },
        {
            "id": "ahVs2LjGIzgNm3Y9m9s68A",
            "date": "2025-02-04",
            "rating": 5,
            "review_title": "",
            "review_text": "Mr. Geller walked me thru my case step by step. He communicates well and makes a terrible situation less stressful. I would use him again.",
            "review_url": "https://www.yelp.com?hrid=ahVs2LjGIzgNm3Y9m9s68A",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=7tmRLWxc4yvpbyonkl8H1w",
            "author_name": "Andrea C.",
            "meta_data": {
                "author_contributions": 2,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "Waimea, HI",
            "response": null
        },
        {
            "id": "30RfBqEYUkX1Ibk4Ml1Yzw",
            "date": "2024-11-30",
            "rating": 5,
            "review_title": "",
            "review_text": "Sam was a lifesaver when my husband and I called him for an urgent matter regarding false DV charges. Speaking to him on our first call , we were assured that we are in the right hands. Sam is very knowledgable about the legal system and clearly explained what we needed to do. He outlined everything that we had to put together for a litigation packet a night before our court date. Before the charges were even filled -  Sam submitted all the required documents to the DA's office ahead of time.  He called and text us constantly on every update. Sam leaded our case with professionalism and integrity and is an excellent attorney! He acted very fast and was instrumental in clearing up the issue for us. I highly recommend Sam for anyone needing a very smart, trustworthy lawyer.",
            "review_url": "https://www.yelp.com?hrid=30RfBqEYUkX1Ibk4Ml1Yzw",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=V2UzOGXC27bn_HuhWsqllA",
            "author_name": "Jaspreet E.",
            "meta_data": {
                "author_contributions": 1,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "Pleasanton, CA",
            "response": null
        },
        {
            "id": "Vxv41gkRnBNacixwx2PkIQ",
            "date": "2024-10-29",
            "rating": 5,
            "review_title": "",
            "review_text": "Samuel Geller has a thorough knowledge of the law and defended my case with determination. I'd highly recommend him to anyone going through legal issues.  Best lawyer in the bay!",
            "review_url": "https://www.yelp.com?hrid=Vxv41gkRnBNacixwx2PkIQ",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=FewtZqvT0ZdIkaouhjnpzA",
            "author_name": "Joel M.",
            "meta_data": {
                "author_contributions": 1,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "San Francisco, CA",
            "response": null
        },
        {
            "id": "TXvKTmydhEj_E851J5sr5Q",
            "date": "2024-10-29",
            "rating": 5,
            "review_title": "",
            "review_text": "It is with the utmost respect and privilege to write this review for Sam Geller. I was charged with a DUI. From the moment I hired Sam as my counsel he was there for me every step of the process - and it is a long process. First, Sam immediately told me what I needed to do in order to get ahead of the case. Follow all of his instructions and you will be on your way to a much better outcome.  There are several mitigating things you must do immediately following being charged. Sam knows what these are and will take you through each one.  Throughout the entire process, Sam was always available to answer my questions through text, email, or a phone call expeditiously. I also want to stress that his expertise coupled with his professionalism were impeccable. Sam is an expert in this area of law. He has a demeanor that is always calm which in turn will put you more at ease and thinking more clearly. I know for a fact, that if I had not hired Sam, the outcome of my case - and in turn, my life- would be much more negative and completely different. Sam's legal representation guaranteed me the best outcome I could possibly have hoped for.  Hire him. It is the best decision you will make. \n\n\n\nI found Sam through Yelp and understand the importance of these reviews. You will be in the best hands should you hire Sam and I fully recommend him without any reservation.",
            "review_url": "https://www.yelp.com?hrid=TXvKTmydhEj_E851J5sr5Q",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=-KI5_VSqsYhk-nxnzuJ83w",
            "author_name": "Sean D.",
            "meta_data": {
                "author_contributions": 4,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "San Francisco, CA",
            "response": null
        },
        {
            "id": "28cNfJTckuah_B1XNJKSjQ",
            "date": "2024-10-18",
            "rating": 5,
            "review_title": "",
            "review_text": "I contacted Samuel for a consultation regarding my case. He responded within minutes after sending an email for a consultation. Samuel was professional, compassionate and very informative. After our initial conversation, I felt very confident with Samuel and moved forward with him to handle my case. Through out the process Samuel kept very good communication and was very patient and informative with all my questions. I would not hesitate to contact Samuel for any other legal issues that may come up.",
            "review_url": "https://www.yelp.com?hrid=28cNfJTckuah_B1XNJKSjQ",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=dByvV-J0q49-lRUPVOFlfQ",
            "author_name": "Marvin",
            "meta_data": {
                "author_contributions": 4,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "South San Francisco, CA",
            "response": null
        },
        {
            "id": "Tc6LIRH1L_jNP16_httzCw",
            "date": "2024-09-04",
            "rating": 5,
            "review_title": "",
            "review_text": "Sam Geller is truly a one of a kind lawyer. My gut feeling was to go with him out of the countless lawyers I had consulted with. He was very informative and eased me through fighting a case and was able to help me to reduce felony charges to misdeameanor after completion of probation even after considering the fact I had priors. He is very good with his practice as long as you listen to what he tells you to do. Would highly recommend and you are getting your money's worth. Thanks again Mr. Geller!!!",
            "review_url": "https://www.yelp.com?hrid=Tc6LIRH1L_jNP16_httzCw",
            "lang": "en",
            "review_imgs": [],
            "review_img_captions": [],
            "author_avatar": "https://s3-media0.fl.yelpcdn.com/assets/srv0/yelp_styleguide/514f6997a318/assets/img/default_avatars/user_60_square.png",
            "author_url": "https://www.yelp.com/user_details?userid=wiFLyoIEXGLe8CL6BAZ5CQ",
            "author_name": "Luis H.",
            "meta_data": {
                "author_contributions": 1,
                "feedback": {
                    "useful": 0,
                    "funny": 0,
                    "cool": 0
                }
            },
            "location": "San Francisco, CA",
            "response": null
        }
    ],
    "meta_data": {
        "lang": "en",
        "lang_stats": [
            {
                "code": "en",
                "count": 149
            }
        ]
    },
    "remaining_credits": 5893050.0
}

Request Cost

1 credit is deducted for each successful request

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com