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.
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 "https://api.scrapingdog.com/yelp/search?api_key=APIKEY&find_desc=burger&find_loc=San+Francisco,CA"
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)
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
$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);
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)
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 &amp; 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 &amp; operated",
"Family-owned &amp; 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 &amp; 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="
}
}
Last updated