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

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

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

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, 50 is the 2nd page of results, 100 is the 3rd page of results, etc.).

num

Optional

Parameter defines the maximum number of results to return. 50 (default) returns 50 results. Maximum number of results to return is 50.

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.

API Examples

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": "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"
  }
}