Yelp Reviews API

Api Details

EndpointGET https://serpapi.abcproxy.com/search

Description

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.abcproxy.com/search?engine=yelp_reviews utilizing a GET request. Head to the playground for a live and interactive demo.

---

Request

HTTP Request

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=yelp_reviews" \
  -d "place_id=MGzro82Fi4LYvc86acoONQ" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "yelp_reviews",
    "place_id": "MGzro82Fi4LYvc86acoONQ",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "yelp_reviews",
  place_id: "MGzro82Fi4LYvc86acoONQ",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=yelp_reviews&place_id=MGzro82Fi4LYvc86acoONQ&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'yelp_reviews',
        'place_id' => 'MGzro82Fi4LYvc86acoONQ',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "yelp_reviews")
    q.Add("place_id", "MGzro82Fi4LYvc86acoONQ")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "yelp_reviews";
        query["place_id"] = "MGzro82Fi4LYvc86acoONQ";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=yelp_reviews" +
            "&place_id=MGzro82Fi4LYvc86acoONQ" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

API Parameters

Search Query

Name	Type	Required	Description	Example
place_id	String	Yes	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.	MGzro82Fi4LYvc86acoONQ

Localization

Name	Type	Required	Description	Example
yelp_domain	String	No	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.	price_low
hl	String	No	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.	en

Advanced Yelp Parameters

Name	Type	Required	Description	Example
q	string	No	Parameter defines the query you want to use to search through Yelp Reviews.	123
sortby	string	No	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	string	No	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 ,).	5
not_recommended	boolean	No	Parameter fetches reviews that are not recommended by Yelp. It can be set to true to only show not recommended reviews, or false to show recommended reviews. By default, only recommended reviews are shown.	trueorfalse

Pagination

Name	Type	Required	Description	Example
start	String	No	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, 49 is the 2nd page of results, 98 is the 3rd page of results, etc.).	1
num	String	No	Parameter defines the maximum number of results to return. 49 (default) returns 49 results. Maximum number of results to return is 49.	49
not_recommended_start	String	No	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.).	1

Serpapi Parameters

Name	Type	Required	Description	Example
engine	String	Yes	Set parameter to yelp_reviews to use the Google Finance API engine.	yelp_reviews
no_cache	boolean	No	Parameter will force SerpApi to fetch the 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.	trueorfalse
api_key	string	Yes	Parameter defines the SerpApi private key to use.	123

---

Response

Success 200

Response Body

{
  "reviews": [
    {
      "position": 1,
      "user": {
        "name": "Justin T.",
        "user_id": "_HvWlhF81mE_l78mswJhvA",
        "link": "https://www.yelp.com/user_details?userid=_HvWlhF81mE_l78mswJhvA",
        "thumbnail": "https://s3-media0.fl.yelpcdn.com/photo/Sbb9jQL36w-XYYpN_LcEJw/180s.jpg",
        "address": "Arcadia, CA",
        "friends": 204,
        "photos": 255,
        "reviews": 95,
        "elite_year": 25
      },
      "comment": {
        "text": "I've heard about Franklin's BBQ being the country's if not the world's best BBQ for many many years and I finally had the chance to try it. I went to Joe's in Kansas City a couple of months ago and was severely disappointed. I waited in line for over 3 years but the moment I tasted the BBQ, especially the Beef Rib, I realized that what I tasted was without a doubt one of the culinary masterpieces in this world. It reminded me of the first time trying A5 Wagyu or King Crab years ago.\n\nTo start off, we got in line on Saturday around 8:30 AM and thankfully we got there because a couple of parties after us weren't guaranteed to be able to order the beef rib anymore. Time flies when you're speaking with others in line, telling stories about your travels and adventures as we all anticipated to indulge in the \"world's best bbq\". From the tender moist brisket (which was a 10/10) to the ribs (for Texas this was a solid 8/10), the best part had to be the beef rib. I've never tasted anything that engulfed my mouth with the flavors and textures that this beef rib had. It was life-changing without a doubt. I've had tons of BBQ in my life, but this one was not only huge but tender and packaged with flavor. Not one ounce of the beef rib was tough or disappointing.\n\nEverything else is just as impressive with the brisket, sausage, and ribs all great. The one slight downside or perhaps my lack of knowledge was why the potato salad was mustard-based. The staff was friendly, responsive, and helpful while offering recommendations.\n\nIf you are looking for one spot to devour beef in America, I can not recommend any other place more than Franklin's BBQ. It's not just a BBQ meal, but it's an entire experience.",
        "language": "en"
      },
      "date": "2025-03-17T22:53:43Z",
      "rating": 5,
      "tags": ["4 photos"],
      "photos": [
        {
          "link": "https://s3-media0.fl.yelpcdn.com/bphoto/CikqYmomWBvC2csgOGRGLg/o.jpg",
          "caption": "Cutting"
        },
        {
          "link": "https://s3-media0.fl.yelpcdn.com/bphoto/trQHfjX8nbiPmmqY0e8Pjg/o.jpg",
          "caption": "Line at 8AM Saturday"
        },
        {
          "link": "https://s3-media0.fl.yelpcdn.com/bphoto/3Dd8MRhePq9tx5fG-7824Q/o.jpg",
          "caption": "Our BBQ Plate"
        },
        {
          "link": "https://s3-media0.fl.yelpcdn.com/bphoto/C5JqunEZMsuhvEYsaQEmfQ/o.jpg",
          "caption": "The beef ribs"
        }
      ],
      "feedback": {
        "useful": 0,
        "funny": 0,
        "cool": 0
      }
    }
  ]
}

Response Fields

Field	Type	Description
search_parameters	Object	Contains query parameters and search context
search_metadata	Object	Contains timing and status information
ReviewLanguages[]	Object[]	Review Languages Information Parameters
Reviews[]	Object[]	Review Information Parameters
SerpapiPagination	string	SerpapiPagination Information Parameters

---

Error Responses

Common Errors

HTTP Status	Error Code	Description
200	400	API Key can not be empty
200	401	Param error
200	402	API Key error
200	403	Insufficient Balance
200	404	Deduction failed
200	405	Failed to record usage count
200	406	Unsupported engine
200	407	Network error
200	408	File not found
200	409	Limit param error
200	410	Build url error
200	411	Failed to QueryRecentRecord
200	412	Failed to find json
200	413	Get html error
200	414	HTML is empty
200	429	Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

---