Yelp Scraper API

The Yelp Scraper API allows developers to Yelp Search Results in real-time. It can be easily accessed by requesting at the following endpoint: api.scrapingdog.com/yelp.

Parameters	Description
api_key required	This is your API key.
find_desc	Type: String The query you want to search.
find_loc required	Type: String The location you want to target to scrape the search results. For example: - San Francisco, CA - New York, NY, United States
l	Type: String The distance or map radius you want to get search results from.
yelp_domain	Type: String The domain you want to use to scrape the search results.
cflt	Type: String It is used to define the category of search results you want.
sortby	Type: String It is used for sorting the result. recommended - Recommended(default) rating - Highest rated review_count - Most reviewed
attrs	Type: String It is used for refining the search results according to the value you pass in attrs parameter.
start	Type: Number(Integer) [0,10,20....] Default: 0 (Enter 10 for 2nd-page results, 20 for 3rd, etc .) The page number to get targeted search results.

Note: Each Yelp API call would cost you 4 request credits.

API Example

cURL

cURL "https://api.scrapingdog.com/yelp/search?api_key=APIKEY&find_desc=burger&find_loc=San+Francisco,CA"

Python

import requests
payload = {'api_key': 'APIKEY', 'find_desc':'burger' , 'find_loc':'San+Francisco,CA'}
resp = requests.get('https://api.scrapingdog.com/yelp/search?', params=payload)
print (resp.text)

Node JS

const axios = require('axios');

axios.get('https://api.scrapingdog.com/yelp/search?api_key=APIKEY&find_desc=burger&find_loc=San+Francisco,CA')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });

PHP

<?php
$url = "https://api.scrapingdog.com/yelp/search?api_key=APIKEY&find_desc=burger&find_loc=San+Francisco,CA";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($ch);
curl_close($ch);
print_r($response);

Ruby

require 'net/http'
require 'json'
params = {
 :api_key => "APIKEY",
 :find_desc => "burger",
 :find_loc => "San+Francisco,CA"
}
uri = URI('https://api.scrapingdog.com/yelp/search')
uri.query = URI.encode_www_form(params)
website_content = Net::HTTP.get(uri)
print(website_content)

Java

try {
 String url = "https://api.scrapingdog.com/yelp/search?api_key=APIKEY&find_desc=burger&find_loc=San+Francisco,CA";
 URL urlForGetRequest = new URL(url);
 String readLine = null;
 HttpURLConnection conection = (HttpURLConnection) urlForGetRequest.openConnection();
 conection.setRequestMethod("GET");
 int responseCode = conection.getResponseCode();
 if (responseCode == HttpURLConnection.HTTP_OK) {
 BufferedReader in = new BufferedReader(new InputStreamReader(conection.getInputStream()));
 StringBuffer response = new StringBuffer();
 while ((readLine = in.readLine()) != null) {
 response.append(readLine);
 }
 in.close();
 System.out.println(response.toString());
} else {
 throw new Exception("Error in API Call");
 }
} catch (Exception ex) {
 ex.printStackTrace();
}

API Response

{
  "filters": {
    "category": [
      {
        "text": "Salad",
        "value": "salad"
      },
      {
        "text": "Fast Food",
        "value": "hotdogs"
      },
      {
        "text": "Gelato",
        "value": "gelato"
      },
      {
        "text": "Halal",
        "value": "halal"
      },
      {
        "text": "Cheesesteaks",
        "value": "cheesesteaks"
      },
      {
        "text": "Georgian",
        "value": "georgian"
      },
      {
        "text": "Pubs",
        "value": "pubs"
      },
      {
        "text": "Food Trucks",
        "value": "foodtrucks"
      },
      {
        "text": "Street Vendors",
        "value": "streetvendors"
      },
      {
        "text": "Sardinian",
        "value": "sardinian"
      },
      {
        "text": "Irish Pub",
        "value": "irish_pubs"
      },
      {
        "text": "Sports Bars",
        "value": "sportsbars"
      },
      {
        "text": "Restaurants",
        "value": "restaurants"
      },
      {
        "text": "Gluten-Free",
        "value": "gluten_free"
      },
      {
        "text": "Beer, Wine & Spirits",
        "value": "beer_and_wine"
      },
      {
        "text": "American",
        "value": "tradamerican"
      },
      {
        "text": "Empanadas",
        "value": "empanadas"
      },
      {
        "text": "Vegetarian",
        "value": "vegetarian"
      },
      {
        "text": "Nightlife",
        "value": "nightlife"
      },
      {
        "text": "Breweries",
        "value": "breweries"
      },
      {
        "text": "Vegan",
        "value": "vegan"
      },
      {
        "text": "Food",
        "value": "food"
      },
      {
        "text": "Food Stands",
        "value": "foodstands"
      },
      {
        "text": "Food Delivery Services",
        "value": "fooddeliveryservices"
      },
      {
        "text": "Desserts",
        "value": "desserts"
      },
      {
        "text": "Gastropubs",
        "value": "gastropubs"
      },
      {
        "text": "Specialty Food",
        "value": "gourmet"
      },
      {
        "text": "Sandwiches",
        "value": "sandwiches"
      },
      {
        "text": "Argentine",
        "value": "argentine"
      },
      {
        "text": "Pasta Shops",
        "value": "pastashops"
      },
      {
        "text": "Beer Bar",
        "value": "beerbar"
      },
      {
        "text": "Wraps",
        "value": "wraps"
      },
      {
        "text": "Delis",
        "value": "delis"
      },
      {
        "text": "Beer Gardens",
        "value": "beergardens"
      },
      {
        "text": "Brewpubs",
        "value": "brewpubs"
      },
      {
        "text": "Kosher",
        "value": "kosher"
      },
      {
        "text": "Pizza",
        "value": "pizza"
      },
      {
        "text": "Sicilian",
        "value": "sicilian"
      },
      {
        "text": "Burgers",
        "value": "burgers"
      },
      {
        "text": "Greek",
        "value": "greek"
      },
      {
        "text": "Tuscan",
        "value": "tuscan"
      },
      {
        "text": "Italian",
        "value": "italian"
      },
      {
        "text": "Wine Bars",
        "value": "wine_bars"
      },
      {
        "text": "Bars",
        "value": "bars"
      },
      {
        "text": "Caterers",
        "value": "catering"
      },
      {
        "text": "Chicken Wings",
        "value": "chicken_wings"
      }
    ],
    "price": [
      {
        "text": "$",
        "value": "RestaurantsPriceRange2.1"
      },
      {
        "text": "$$",
        "value": "RestaurantsPriceRange2.2"
      },
      {
        "text": "$$$",
        "value": "RestaurantsPriceRange2.3"
      },
      {
        "text": "$$$$",
        "value": "RestaurantsPriceRange2.4"
      }
    ],
    "distance": [
      {
        "text": "Biking (2 mi.)",
        "value": "g:-74.01987075805664,40.685975199914836,-73.96871566772461,40.72501469240076"
      },
      {
        "text": "Bird's-eye View",
        "value": "g:-74.09660339355469,40.62750334315296,-73.89198303222656,40.783660996197945"
      },
      {
        "text": "Within 4 blocks",
        "value": "g:-73.99749040603638,40.70300899253094,-73.99109601974487,40.70788893269148"
      },
      {
        "text": "Walking (1 mi.)",
        "value": "g:-74.00708198547363,40.69567214301143,-73.98150444030762,40.715191908398225"
      },
      {
        "text": "Driving (5 mi.)",
        "value": "g:-74.04544830322266,40.666316664620794,-73.9431381225586,40.744395800976775"
      }
    ]
  },
  "inline_ads": [
    
  ],
  "sponsored_ads": [
    {
      "place_ids": [
        "oOr6Ta5gZyDl6PyZ1cq7pg",
        "east-village-pizza-new-york"
      ],
      "title": "East Village Pizza",
      "link": "/adredir?ad_business_id=oOr6Ta5gZyDl6PyZ1cq7pg&campaign_id=W_GBfwGBGEn2RozoCdt6TQ&click_origin=search_results&placement=vertical_0&placement_slot=1&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Feast-village-pizza-new-york&request_id=221eb259ab5c54a2&signature=6cdd44b5b9f359a263b66d0d0123a04b4061ead2da09cde1fde2d673d8cdacf8&slot=0",
      "reviews_url": "/adredir?ad_business_id=oOr6Ta5gZyDl6PyZ1cq7pg&campaign_id=W_GBfwGBGEn2RozoCdt6TQ&click_origin=search_results&placement=vertical_0&placement_slot=1&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Feast-village-pizza-new-york%23reviews&request_id=221eb259ab5c54a2&signature=894d124c18ce24682ffc3a499b727e23fe96dbbbcc43972a02b2322cb36b07f4&slot=0",
      "categories": [
        {
          "title": "Italian",
          "url": "/search?find_desc=Italian&find_loc=New+York%2C+NY"
        },
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.1,
      "reviews": 563,
      "neighborhoods": [
        "East Village"
      ],
      "highlights": [
        "Grab-and-go",
        "Vegetarian friendly",
        "Casual dining",
        "Family-owned & operated",
        "27 years in business",
        "Outdoor seating"
      ],
      "button": {
        "text": "Start Order",
        "link": "/adredir?ad_business_id=oOr6Ta5gZyDl6PyZ1cq7pg&click_origin=search_results_platform&placement=vertical_0&placement_slot=1&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Feast-village-pizza-new-york%3Fshow_platform_modal%3DTrue&request_id=221eb259ab5c54a2&signature=adefdc0b5aa6f0a9f4fd48a6ba7752beab26ffccb3b8b855385d1c1aa8b3e0a5&slot=0"
      }
    },
    {
      "place_ids": [
        "42DvyoCwh6QcNA7URLiLkQ",
        "nuovo-york-pizza-new-york"
      ],
      "title": "Nuovo York Pizza",
      "link": "/adredir?ad_business_id=42DvyoCwh6QcNA7URLiLkQ&campaign_id=SSnnjJR-qHU42Cmyi5m-Aw&click_origin=search_results&placement=vertical_0&placement_slot=1&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fnuovo-york-pizza-new-york&request_id=221eb259ab5c54a2&signature=6e6cf8f40e49f4f6e13d12d4a38004a39f111361972a60f764baaa42c7a16491&slot=1",
      "reviews_url": "/adredir?ad_business_id=42DvyoCwh6QcNA7URLiLkQ&campaign_id=SSnnjJR-qHU42Cmyi5m-Aw&click_origin=search_results&placement=vertical_0&placement_slot=1&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fnuovo-york-pizza-new-york%23reviews&request_id=221eb259ab5c54a2&signature=7a216a564fc49669e5cc352e9cb2755f7db07cad2d298ae1f86800d9a01477d2&slot=1",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.6,
      "reviews": 66,
      "neighborhoods": [
        "East Village"
      ],
      "highlights": [
        "Locally owned & operated",
        "Family-owned & operated"
      ],
      "button": {
        "text": "Start Order",
        "link": "/adredir?ad_business_id=42DvyoCwh6QcNA7URLiLkQ&click_origin=search_results_platform&placement=vertical_0&placement_slot=1&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fnuovo-york-pizza-new-york%3Fshow_platform_modal%3DTrue&request_id=221eb259ab5c54a2&signature=10f70c0dc49ac9a5714977e4a16582aebca561145559b7efb39aaf8f6dc4c297&slot=1"
      }
    },
    {
      "place_ids": [
        "8ZZz2PXIXIA6OmpIZpI4aQ",
        "traditas-pizza-new-york-2"
      ],
      "title": "Traditas Pizza",
      "link": "/adredir?ad_business_id=8ZZz2PXIXIA6OmpIZpI4aQ&campaign_id=wm1sHpTw6rMEPEMSHBESxA&click_origin=search_results&placement=below_search&placement_slot=2&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Ftraditas-pizza-new-york-2&request_id=221eb259ab5c54a2&signature=64e4dc96a8e1b570c1cc5d19525c352e0e7812dfc6c9c08356bf5d637900d938&slot=0",
      "reviews_url": "/adredir?ad_business_id=8ZZz2PXIXIA6OmpIZpI4aQ&campaign_id=wm1sHpTw6rMEPEMSHBESxA&click_origin=search_results&placement=below_search&placement_slot=2&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Ftraditas-pizza-new-york-2%23reviews&request_id=221eb259ab5c54a2&signature=11f06e05ea34dc00c112659e7775289cca2552b0017ff09102a253984ef04a50&slot=0",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.6,
      "reviews": 51,
      "neighborhoods": [
        "Flatiron"
      ],
      "highlights": [
        "Family-owned & operated",
        "Casual dining",
        "Gluten-free friendly ",
        "Outdoor seating"
      ],
      "button": {
        "text": "Start Order",
        "link": "/adredir?ad_business_id=8ZZz2PXIXIA6OmpIZpI4aQ&click_origin=search_results_platform&placement=below_search&placement_slot=2&redirect_url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Ftraditas-pizza-new-york-2%3Fshow_platform_modal%3DTrue&request_id=221eb259ab5c54a2&signature=dc78f86ec365112a51f056ed2bd0c1116f4fbc8090577176df481e379a7f417e&slot=0"
      }
    }
  ],
  "organic_results": [
    {
      "place_ids": [
        "ysqgdbSrezXgVwER2kQWKA",
        "julianas-brooklyn-3"
      ],
      "title": "Juliana’s",
      "link": "/biz/julianas-brooklyn-3?osq=pizza",
      "reviews_url": "/biz/julianas-brooklyn-3?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.4,
      "reviews": 2822,
      "neighborhoods": [
        "DUMBO"
      ],
      "price_range": "$$",
      "button": {
        
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/od36nFW220aMFAnNP00ocw/348s.jpg"
    },
    {
      "place_ids": [
        "zj8Lq1T8KIC5zwFief15jg",
        "prince-street-pizza-new-york-2"
      ],
      "title": "Prince Street Pizza",
      "link": "/biz/prince-street-pizza-new-york-2?osq=pizza",
      "reviews_url": "/biz/prince-street-pizza-new-york-2?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        },
        {
          "title": "Italian",
          "url": "/search?find_desc=Italian&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.3,
      "reviews": 5395,
      "neighborhoods": [
        "Nolita"
      ],
      "price_range": "$",
      "button": {
        
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/Jo9jBP5y6G_bG_g3H31fiw/348s.jpg"
    },
    {
      "place_ids": [
        "G9hV4H2iGpWD8RoUpjtokg",
        "l-industrie-pizzeria-new-york"
      ],
      "title": "L’industrie Pizzeria",
      "link": "/biz/l-industrie-pizzeria-new-york?osq=pizza",
      "reviews_url": "/biz/l-industrie-pizzeria-new-york?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.6,
      "reviews": 409,
      "neighborhoods": [
        "West Village"
      ],
      "price_range": "",
      "button": {
        
      },
      "service_options": {
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/Hzdlv1PI6ZM60HzVwxUc8A/348s.jpg"
    },
    {
      "place_ids": [
        "v1DHGRNCH9247WLYoaoA9A",
        "l-industrie-pizzeria-brooklyn"
      ],
      "title": "L’industrie Pizzeria",
      "link": "/biz/l-industrie-pizzeria-brooklyn?osq=pizza",
      "reviews_url": "/biz/l-industrie-pizzeria-brooklyn?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.7,
      "reviews": 1413,
      "neighborhoods": [
        "Williamsburg - South Side"
      ],
      "price_range": "$$",
      "button": {
        
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": false,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/1-VBwAOj0g9YKYey3V-Z6Q/348s.jpg"
    },
    {
      "place_ids": [
        "KEEXuHCYhsQJ-zpJhu98bA",
        "joes-pizza-new-york-148"
      ],
      "title": "Joe’s Pizza",
      "link": "/biz/joes-pizza-new-york-148?osq=pizza",
      "reviews_url": "/biz/joes-pizza-new-york-148?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.2,
      "reviews": 2365,
      "neighborhoods": [
        "Theater District"
      ],
      "price_range": "$",
      "button": {
        "text": "Start Order",
        "link": "/biz/KEEXuHCYhsQJ-zpJhu98bA?show_platform_modal=True"
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/FluVgKezP5ifs7greHV8Qg/348s.jpg"
    },
    {
      "place_ids": [
        "uc5qQMzs96rzjK27epDCug",
        "joes-pizza-new-york-4"
      ],
      "title": "Joe’s Pizza",
      "link": "/biz/joes-pizza-new-york-4?osq=pizza",
      "reviews_url": "/biz/joes-pizza-new-york-4?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.1,
      "reviews": 3206,
      "neighborhoods": [
        "West Village"
      ],
      "price_range": "$",
      "button": {
        
      },
      "service_options": {
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/FKjd9RGuNH-ixnd7AQxj0g/348s.jpg"
    },
    {
      "place_ids": [
        "Q9F2ocrmYuGt1yn3M7MOBw",
        "lucali-brooklyn-3"
      ],
      "title": "Lucali",
      "link": "/biz/lucali-brooklyn-3?osq=pizza",
      "reviews_url": "/biz/lucali-brooklyn-3?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.2,
      "reviews": 2113,
      "neighborhoods": [
        "Carroll Gardens"
      ],
      "price_range": "$$",
      "button": {
        
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/rMlNCZkNG2Nizhp8aBYKng/348s.jpg"
    },
    {
      "place_ids": [
        "WG639VkTjmK5dzydd1BBJA",
        "rubirosa-new-york-2"
      ],
      "title": "Rubirosa",
      "link": "/biz/rubirosa-new-york-2?osq=pizza",
      "reviews_url": "/biz/rubirosa-new-york-2?osq=pizza#reviews",
      "categories": [
        {
          "title": "Italian",
          "url": "/search?find_desc=Italian&find_loc=New+York%2C+NY"
        },
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.3,
      "reviews": 3438,
      "neighborhoods": [
        "Nolita"
      ],
      "price_range": "$$",
      "button": {
        
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/l0Phrnhhj78RFiDhLIOUyQ/348s.jpg"
    },
    {
      "place_ids": [
        "-9NO2IDCJMyNGZMAQ1-VQw",
        "ny-pizza-suprema-new-york"
      ],
      "title": "NY Pizza Suprema",
      "link": "/biz/ny-pizza-suprema-new-york?osq=pizza",
      "reviews_url": "/biz/ny-pizza-suprema-new-york?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.3,
      "reviews": 2706,
      "neighborhoods": [
        "Chelsea"
      ],
      "price_range": "$$",
      "button": {
        "text": "Start Order",
        "link": "/biz/-9NO2IDCJMyNGZMAQ1-VQw?show_platform_modal=True"
      },
      "service_options": {
        "Outdoor seating": false,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/EqbDXneMuQP6pw6GemVdQA/348s.jpg"
    },
    {
      "place_ids": [
        "oJ_XSPZFpvIt6rvheSQl7A",
        "bleecker-street-pizza-new-york"
      ],
      "title": "Bleecker Street Pizza",
      "link": "/biz/bleecker-street-pizza-new-york?osq=pizza",
      "reviews_url": "/biz/bleecker-street-pizza-new-york?osq=pizza#reviews",
      "categories": [
        {
          "title": "Pizza",
          "url": "/search?find_desc=Pizza&find_loc=New+York%2C+NY"
        },
        {
          "title": "Italian",
          "url": "/search?find_desc=Italian&find_loc=New+York%2C+NY"
        }
      ],
      "rating": 4.2,
      "reviews": 3162,
      "neighborhoods": [
        "West Village"
      ],
      "price_range": "$",
      "button": {
        "text": "Start Order",
        "link": "/biz/oJ_XSPZFpvIt6rvheSQl7A?show_platform_modal=True"
      },
      "service_options": {
        "Outdoor seating": true,
        "Delivery": true,
        "Takeout": true
      },
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/uScs5HVlHXaZMKIroDaHSg/348s.jpg"
    }
  ],
  "pagination": {
    "next": "https://www.yelp.com/search?find_desc=pizza&find_loc=New York, NY, USA&start="
  }
}