🍽️ Yelp Business & Reviews Scraper

Scrape Yelp business listings and reviews at scale. Search by query + location, or provide direct business URLs. Extract structured data including ratings, reviews, contact info, and more.

Features

• Dual strategy — Yelp Fusion API (recommended) or web scraping fallback
• Search scraping — Find businesses by keyword and location
• Direct URL scraping — Provide specific Yelp business URLs
• Review extraction — Get full review text, author, rating, and date
• Pagination — Automatically follows search result pages
• Anti-blocking — Residential proxies, session rotation, fingerprinting

Input

Field	Type	Description	Default
searchQuery	string	Search term (e.g., "pizza", "plumber")	"restaurants"
location	string	Location (e.g., "New York, NY")	"New York, NY"
businessUrls	array	Direct Yelp business URLs	[]
maxBusinesses	integer	Max businesses to return	20
maxReviewsPerBusiness	integer	Max reviews per business	10
scrapeReviews	boolean	Extract individual reviews	true
yelpApiKey	string	Yelp Fusion API key (recommended)	—

Recommended: Use Yelp Fusion API

Yelp aggressively blocks web scrapers. For reliable results, provide a Yelp Fusion API key:

1. Sign up at fusion.yelp.com
2. Create an app to get your API key
3. Free tier: 5,000 API calls/day
4. Enter the key in the yelpApiKey input field

Without an API key, the scraper falls back to web scraping with residential proxies, which may have lower success rates.

Output

Each business result includes:

{
  "url": "https://www.yelp.com/biz/example-restaurant-san-francisco",
  "name": "Example Restaurant",
  "rating": 4.5,
  "reviewCount": 1234,
  "address": "123 Main St, San Francisco, CA 94102",
  "phone": "(415) 555-0123",
  "categories": ["Italian", "Pizza"],
  "priceRange": "$$",
  "reviews": [
    {
      "author": "John D.",
      "rating": 5,
      "date": "2024-01-15",
      "text": "Amazing food and great service..."
    }
  ]
}

Usage Examples

Search for restaurants

{
  "searchQuery": "restaurants",
  "location": "San Francisco, CA",
  "maxBusinesses": 50,
  "yelpApiKey": "your-api-key-here"
}

Scrape specific businesses

{
  "businessUrls": [
    "https://www.yelp.com/biz/example-restaurant"
  ],
  "scrapeReviews": true
}

Cost

• With API key: Minimal compute (API calls only), ~$0.25 per 100 businesses
• Web scraping: Higher compute due to browser rendering, ~$1-2 per 100 businesses
• Residential proxy usage applies to web scraping mode

Limitations

• Yelp Fusion API returns up to 3 reviews per business (API limit)
• Web scraping may be blocked during high-traffic periods
• Maximum 1000 search results per query (Yelp API limit)