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
). Only the first ID type is supported (e.g. ED7A7vDdg8yLNKJTSVHHmg
). To extract the ID 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.
Advanced Yelp Parameters
sortby
Optional
Parameter is used for sorting results. Available options:relevance_desc
- Yelp Sort (default)date_desc
- Newest Firstdate_asc
- Oldest Ratedrating_desc
- Highest Ratedrating_asc
- Lowest Ratedelites_desc
- Elites
rating
Optional
Parameter filters out the results by rating. Possible values are 5
, 4
, 3
, 2
, and 1
. All results are included by default.
To only show results with the five star rating, the value should be set to 5
To include results with multiple ratings, the value should for example be set to 5,4,3
(each rating separated by comma ,
).
Pagination
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.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false
(default) or true
. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
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": "65cc6a6d9656229c2c826161",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/da0df0e0741b810c/65cc6a6d9656229c2c826161.json",
"created_at": "2024-02-14 07:23:25 UTC",
"processed_at": "2024-02-14 07:23:25 UTC",
"yelp_reviews_url": "https://www.yelp.com/biz/-4ofMtrD7pSpZIX5pnDkig?sort_by=relevance_desc",
"raw_html_file": "https://serpapi.com/searches/da0df0e0741b810c/65cc6a6d9656229c2c826161.html",
"prettify_html_file": "https://serpapi.com/searches/da0df0e0741b810c/65cc6a6d9656229c2c826161.prettify",
"total_time_taken": 1.16
},
"search_parameters": {
"engine": "yelp_reviews",
"start": 0,
"num": "50",
"place_id": "-4ofMtrD7pSpZIX5pnDkig"
},
"search_information": {
"total_results": 1887,
"business": "Mozart's Coffee Roasters"
},
"review_languages": [
{
"hl": "en",
"count": 1887
},
{
"hl": "es",
"count": 2
},
{
"hl": "fr",
"count": 1
}
],
"reviews": [
{
"user": {
"name": "Lauren R.",
"user_id": "lrPJdqIBvwT97HmNt-SAxA",
"link": "https://www.yelp.com/user_details?userid=lrPJdqIBvwT97HmNt-SAxA",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/MND_w9MARpV1lbsHCli4bw/180s.jpg",
"address": "Austin, TX",
"friends": 75,
"photos": 28,
"reviews": 190
},
"comment": {
"text": "I really love this place. It's been a place for me to work, write, relax, meet with friends and bring family from out of town.\n\nTheir desserts and food options are plentiful, and all tasty (at least the variations I have had). I think it's reasonably priced, too.\n\nDefinitely check it out if you haven't already! It's an Austin gem.",
"language": "en"
},
"date": "2024-01-08T01:49:24Z",
"rating": 5,
"feedback": {
"useful": 0,
"funny": 0,
"cool": 0
},
"owner_replies": [
{
"owner": {
"name": "Sabrina H.",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/buphoto/pFNwAXH64Ht1NxUYjekfhA/90s.jpg",
"role": "OWNER"
},
"comment": "We’re so glad that you love it! It’s a gem because we have customers like you! Thank you for coming to Mozarts!",
"date": "2024-01-15T17:08:04Z"
}
]
},
{
"user": {
"name": "Kseniya K.",
"user_id": "wom1WWarGvu24KJi9tquSw",
"link": "https://www.yelp.com/user_details?userid=wom1WWarGvu24KJi9tquSw",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/LrkaIFypIA1HayN_EikFUQ/180s.jpg",
"address": "Brooklyn, NY",
"friends": 415,
"photos": 2367,
"reviews": 514,
"elite_year": 24
},
"comment": {
"text": "Beautiful, scenic outdoor seating spaces are the main draw of this establishment. Tons of people hold business meetings, friend & family hangouts, and their \"work from home\" sessions here. There is a lot of space, so you won't be bothered. Tons of indoor space is also available. Parking is on premises, across the road.\n\nMenu of desserts and savory bites [empanadas, quiches, burritos, sandwiches, and empanadas] is extensive, but expensive, at $8.25 per pastry. $9 Veggie quiche was tasty, with light and flaky crust and rich, thick filling. You'll be full for a long time after such bite. Coffee, tea, and cocoa are also up there in prices. But that's Austin in general, now. Hurray inflation.\n\nOn 1pm on certain days [like Thursdays] there are live musical performances happening on premises. Depending on the performer, you get to enjoy a treat. Most performers are just learning, so they use this venue to hone in and practice their beginner skills.",
"language": "en"
},
"date": "2024-01-25T20:13:37Z",
"rating": 4,
"tags": [
"7 photos",
"1 check-in"
],
"photos": [
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/1L06iMWYWP0N4pai5bvIeQ/o.jpg"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/Jtlf3qTyimcJ2tIQShY3_Q/o.jpg"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/B5-DS5fAW2PdVBRLiRDylA/o.jpg"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/yhBlYXsdeQW5pe0zUnPsKw/o.jpg"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/AUeD1tvv1jPcrQlwvltWUw/o.jpg",
"caption": "$9 quiche"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/rX9lm18TJyQmsak6s2OlMg/o.jpg",
"caption": "Hungry Denizens"
},
{
"link": "https://s3-media0.fl.yelpcdn.com/bphoto/eTAYFAIFS19YEK1Vm1ckBg/o.jpg",
"caption": "Views"
}
],
"feedback": {
"useful": 2,
"funny": 0,
"cool": 1
}
},
{
"user": {
"name": "Chris K.",
"user_id": "2lx3zmCrqA5yLiLzv3sHdQ",
"link": "https://www.yelp.com/user_details?userid=2lx3zmCrqA5yLiLzv3sHdQ",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/57HVfSkhFdt2--fwBEdS0Q/180s.jpg",
"address": "Addison, TX",
"friends": 69,
"photos": 48,
"reviews": 90
},
"comment": {
"text": "I have been coming here for years when coming down to Austin. I always come for the beautiful lake view. But Saturday's line was just a mess. A sign said to form one line. So everyone formed one line. I saw a lady asking where the line was and people in line pointed to the back of the existing line. She completely ignored this and made a new line. Well, guess what? More people were standing in this new line cutting off the existing line. Could Mozart handled this differently? Yes.\n\nTheir cold brew is great but trying to fight your way to the front of the new line was a turnoff.",
"language": "en"
},
"date": "2024-01-22T05:11:02Z",
"rating": 3,
"feedback": {
"useful": 0,
"funny": 0,
"cool": 0
},
"owner_replies": [
{
"owner": {
"name": "Sabrina H.",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/buphoto/pFNwAXH64Ht1NxUYjekfhA/90s.jpg",
"role": "OWNER"
},
"comment": "Chris, \nWe appreciate your concern and candid feedback. We will send this to management right away and hope you join us again to enjoy your amazing coffee!!",
"date": "2024-01-23T20:17:54Z"
}
]
},
...
],
"serpapi_pagination": {
"next": "https://serpapi.com/search.json?engine=yelp_reviews&num=50&place_id=-4ofMtrD7pSpZIX5pnDkig&sortby=relevance_desc&start=50"
}
}