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.
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.
Advanced Yelp Parameters
q
Optional
Parameter defines the query you want to use to search through Yelp Reviews.
sortby
Optional
Parameter is used for sorting results. Available options:
relevance_desc
- Yelp Sort (default)
date_desc
- Newest First
date_asc
- Oldest Rated
rating_desc
- Highest Rated
rating_asc
- Lowest Rated
elites_desc
- Elites
Pagination
start
Optional
Parameter defines the result offset. It skips the given number of results. 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.).
Serpapi Parameters
engine
Required
Set parameter to yelp_reviews
to use the Yelp Reviews API engine.
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_key
Required
Parameter defines the SerpApi private key to use.
output
Optional
Parameter defines the final output you want. It can be set to json (default) to get a structured JSON
of the results, or html
to get the raw html retrieved.
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.
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
}
},
...
]
}
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.
Advanced Yelp Parameters
q
Optional
Parameter defines the query you want to use to search through Yelp Reviews.
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
Pagination
start
Optional
Parameter defines the result offset. It skips the given number of results. 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.).
Serpapi Parameters
engine
Required
Set parameter to yelp_reviews
to use the Yelp Reviews API engine.
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_key
Required
Parameter defines the SerpApi private key to use.
output
Optional
Parameter defines the final output you want. It can be set to json (default) to get a structured JSON
of the results, or html
to get the raw html retrieved.
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.
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
}
},
...
]
}