Yelp Reviews API
Our Yelp Reviews API allows you to scrape results from the Yelp Place search page. The API is accessed through the following endpoint: /search?engine=yelp_reviews. A user may query the following: https://serpapi.com/search?engine=yelp_reviews utilizing a GET request. Head to the playground for a live and interactive demo.
API Parameters
Search Query
place_id
Required
Parameter defines the Yelp ID of a place. Each place has two unique IDs (e.g. ED7A7vDdg8yLNKJTSVHHmg and arabica-brooklyn) and you can use either of them as a value of the place_id. To extract the IDs of a place you can use our Yelp Search API.
Localization
yelp_domain
Optional
Parameter defines the Yelp domain to use. It defaults to yelp.com. Head to the Yelp domains for a full list of supported Yelp domains.
hl
Optional
Parameter defines the language to use for sorting Yelp Reviews. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French) Head to the Yelp Reviews languages for a full list of supported Yelp Reviews languages.
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Yelp Reviews results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
API Results
JSON Results
JSON output includes structured data for Reviews results and Review Languages results.
A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.
HTML Results
HTML output is useful to debug JSON results or support features not supported yet by SerpApi. HTML output gives you the raw HTML results from Yelp Reviews.
This API does not have html response, just a text. search_metadata.prettify_html_file contains prettified version of the result. It is displayed in the playground.
API Examples
Example with place_id: -4ofMtrD7pSpZIX5pnDkig for "Mozart's Coffee Roasters"
{
"search_metadata": {
"id": "6274e8e4cb52ed2d68fe1e0d",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/14bb869ee6f18a00/6274e8e4cb52ed2d68fe1e0d.json",
"created_at": "2022-05-06 09:22:44 UTC",
"processed_at": "2022-05-06 09:22:44 UTC",
"yelp_reviews_url": "https://www.yelp.com/biz/mozarts-coffee-roasters-austin/review_feed?",
"raw_html_file": "https://serpapi.com/searches/14bb869ee6f18a00/6274e8e4cb52ed2d68fe1e0d.html",
"prettify_html_file": "https://serpapi.com/searches/14bb869ee6f18a00/6274e8e4cb52ed2d68fe1e0d.prettify",
"total_time_taken": 2.11
},
"search_parameters": {
"engine": "yelp_reviews",
"place_id": "mozarts-coffee-roasters-austin"
},
"search_information": {
"total_results": 1620,
"language": "en",
"business": "Mozart's Coffee Roasters"
},
"review_languages": [
{
"hl": "en",
"count": 1620
},
{
"hl": "es",
"count": 2
}
],
"reviews": [
{
"user": {
"name": "Stephanie L.",
"user_id": "Y3nzTZhiwcKcsJBEHY2QfA",
"link": "https://www.yelp.com/user_details?userid=Y3nzTZhiwcKcsJBEHY2QfA",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/pk_KtMsjKrCyMIZvjQGBrQ/60s.jpg",
"address": "Lakewood, CA",
"friends": 80,
"photos": 2655,
"reviews": 181,
"elite_year": 2022
},
"comment": {
"text": "Definitely a place to check out. Beautiful deck seating with the waterfront view of the lake. Lots of space to chill, study, and work at this cafe. The weather on the day we went was just perfect. It was cloudy and not very sunny, there was a breeze so we sat on the deck. There is a lot of options for foods, from savory to sweet. The coffee menu is extensive, tbh quite overwhelming. Draft Latte is delicious, creamy and sweet cold brew! Italian soda is average.This cafe opens until midnight, perfect for studying or to hang out. Definitely one of my favorite place in Austin!",
"language": "en"
},
"date": "5/5/2022",
"rating": 5,
"tags": [
"9 photos",
"1 check-in"
],
"photos": [
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/Nq3DisPpoupepbdfQH4LRg/o.jpg",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/TGcADOw1K5T830VvrEleHA/o.jpg",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/ugCneb43AaHudPgAMuSW_w/o.jpg",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/B5H32UaD-WnT8iUshEpIEw/o.jpg",
"caption": "Hazelnut Torte Cake & Draft Latte",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/wS1c2ZQ5uVhgzv3cV-vKPQ/o.jpg",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/SvyIjyZfbCOVuNtkNKOcCQ/o.jpg",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/_J9LHSoQ9fZ4NMiOYVjWwg/o.jpg",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/jfiCh4xDtAHD8yURgj1r9w/o.jpg",
"caption": "Bagel & Italian soda",
"uploaded": "May 5, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/-GsVLPuX3Fd5W11ylHa-_g/o.jpg",
"caption": "Outdoor seatin",
"uploaded": "May 5, 2022"
}
],
"feedback": {
"useful": 2,
"funny": 1,
"cool": 3
}
},
{
"user": {
"name": "Marie P.",
"user_id": "iHyJ6b7Q-jmnITYghIoV3w",
"link": "https://www.yelp.com/user_details?userid=iHyJ6b7Q-jmnITYghIoV3w",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/Hm5fNtK7RWjED4BxNWqXiw/60s.jpg",
"address": "Austin, TX",
"friends": 16,
"photos": 3,
"reviews": 5
},
"comment": {
"text": "Such a great coffee spot by the water, with great atmosphere, all year around. I love their hot/iced lattes and nitro coffee beverages.Truly recommend",
"language": "en"
},
"date": "5/3/2022",
"rating": 5
},
{
"user": {
"name": "Darlene B.",
"user_id": "_siU43gk5EdTnuYRMeqlFg",
"link": "https://www.yelp.com/user_details?userid=_siU43gk5EdTnuYRMeqlFg",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/cx0O68ogV-0EpFUWsxlnug/60s.jpg",
"address": "Austin, TX",
"friends": 210,
"photos": 348,
"reviews": 150,
"elite_year": 2022
},
"comment": {
"text": "One of my favorite coffee shops for the vibe and views! It's right on the lake, and they have live music to enjoy with your coffee, what more could you ask for?! Lots of options for pastry and coffee or brew - whatever you're in the mood for. They also have a little shop where you can purchase tshirts, coffee mugs, coffee beans, and more! My favorite beans from there is the vecchi amici - Italian dark roast - so smooth and rich! Perfect for a shot of espresso, affogato, or latte with your favorite flavor! I always take my out of town guests here and I typically spend some afternoons or weekends reading a book and enjoying the Austin weather!",
"language": "en"
},
"date": "4/29/2022",
"rating": 4,
"tags": [
"4 photos"
],
"photos": [
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/Df1GpswCIYneoRJSOybudg/o.jpg",
"uploaded": "April 29, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/jB7p06ivVgVc_Nu-QIafwQ/o.jpg",
"uploaded": "April 29, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/7rkxtWKMjwqLw5iZUrrixQ/o.jpg",
"uploaded": "April 29, 2022"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/pYepBKWwwDQmtmNQBEKG5A/o.jpg",
"uploaded": "April 29, 2022"
}
],
"feedback": {
"useful": 1
}
},
...
]
}