Yelp Reviews API
Scrape Yelp business reviews and ratings with a simple API call
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 |
|
1 2 3 4 5 |
|
1 2 3 |
|
1 2 3 4 5 6 |
|
1 2 3 4 5 6 |
|
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