Yelp Scraper API

The Yelp Scraper API lets you extract business listings from Yelp by keyword and location, with support for category filters, sorting, and pagination. Each successful request costs 4 API credits.

Endpoint: https://api.scrapingdog.com/yelp/search

API Parameters

🔑

Scrapingdog Parameters

api_key Required
Your personal API key. Available on your dashboard.

Type: String

🔍

Search Query

find_desc Optional
The search query term (e.g., burger, pizza, coffee).

Type: String
find_loc Required
Target location for the search (e.g., San Francisco, CA).

Type: String

⚙

️ Filters

cflt Optional
Category filter to narrow results to a specific Yelp category (e.g., restaurants, bars).

Type: String
sortby Optional
Sort method for results. Accepted values: recommended, rating, review_count. Default: recommended.

Type: String
attrs Optional
Refine results by business attributes (e.g., GoodForKids, WheelchairAccessible).

Type: String
l Optional
Distance or map radius string to narrow results by geographic area.

Type: String
yelp_domain Optional
The Yelp domain to scrape (e.g., yelp.com, yelp.co.uk).

Type: String
start Optional
Pagination offset. Use multiples of 10 to paginate through results (e.g., 10, 20). Default: 0.

Type: Integer

API Examples

Code to Integrate

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

import requests

params = {
    "api_key": "APIKEY",
    "find_desc": "burger",
    "find_loc": "San Francisco, CA"
}

response = requests.get("https://api.scrapingdog.com/yelp/search", params=params)
print(response.json())

const params = new URLSearchParams({
  api_key: "APIKEY",
  find_desc: "burger",
  find_loc: "San Francisco, CA"
});

const response = await fetch(`https://api.scrapingdog.com/yelp/search?${params}`);
const data = await response.json();
console.log(data);

<?php
$url = 'https://api.scrapingdog.com/yelp/search?' . http_build_query([
    'api_key'   => 'APIKEY',
    'find_desc' => 'burger',
    'find_loc'  => 'San Francisco, CA',
]);
echo file_get_contents($url);

API Response

{
  "filters": {
    "category": [
      { "text": "Salad", "value": "salad" },
      { "text": "Fast Food", "value": "hotdogs" }
    ],
    "price": [
      { "text": "$", "value": "RestaurantsPriceRange2.1" },
      { "text": "$$", "value": "RestaurantsPriceRange2.2" }
    ],
    "distance": [
      { "text": "Biking (2 mi.)", "value": "g:-74.01987075805664,40.685975199914836,-73.96871566772461,40.72501469240076" }
    ]
  },
  "inline_ads": [],
  "sponsored_ads": [
    {
      "title": "East Village Pizza",
      "url": "https://www.yelp.com/biz/east-village-pizza-new-york",
      "rating": 4.5,
      "review_count": 1243,
      "price": "$$",
      "categories": ["Pizza"],
      "neighborhood": "East Village"
    }
  ],
  "organic_results": [
    {
      "title": "Juliana's",
      "url": "https://www.yelp.com/biz/julianas-brooklyn",
      "rating": 4.5,
      "review_count": 3892,
      "price": "$$",
      "categories": ["Pizza"],
      "neighborhood": "Brooklyn Heights",
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/julianas.jpg"
    },
    {
      "title": "Prince Street Pizza",
      "url": "https://www.yelp.com/biz/prince-street-pizza-new-york",
      "rating": 4.0,
      "review_count": 2145,
      "price": "$",
      "categories": ["Pizza"],
      "neighborhood": "NoLita",
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/prince-street.jpg"
    },
    {
      "title": "L'industrie Pizzeria",
      "url": "https://www.yelp.com/biz/lindustrie-pizzeria-brooklyn",
      "rating": 4.5,
      "review_count": 1678,
      "price": "$",
      "categories": ["Pizza"],
      "neighborhood": "Williamsburg",
      "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/lindustrie.jpg"
    }
  ],
  "pagination": {
    "next": "https://www.yelp.com/search?find_desc=pizza&find_loc=New+York,+NY,+USA&start=10"
  }
}