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"

Example with place_id: -4ofMtrD7pSpZIX5pnDkig for "Mozart's Coffee Roasters"

JSON Example

{
  "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
      }
    },
    ...
  ]
}