Yelp Business Scraper - Profiles, Reviews, Ratings & Photos

Scrape Yelp business profiles, customer reviews, ratings, photos, and business attributes at scale. Get comprehensive local business data including hours, amenities, price ranges, and owner responses. Essential for reputation monitoring, competitive analysis, lead generation, and market research.

Features

• Profile Scraping - Complete business profile data with all attributes
• Search - Find businesses by name, category, location, and filters
• Review Extraction - Customer reviews with ratings, dates, and engagement metrics
• Photo URLs - Business and user-uploaded photos
• Business Attributes - Hours, parking, amenities, services offered
• Price Range Filtering - Filter by $ to $$$$ price levels
• Category Filtering - Yelp's full category taxonomy
• Elite Reviewer Identification - Flag reviews from Yelp Elite members
• Owner Responses - Capture business owner replies to reviews
• Anti-Detection - Fingerprint injection for stealth browsing
• No Login Required - Works with public Yelp data
• Demo Mode - Test with sample data before going live

Who Should Use This Actor?

Local SEO Agencies

Monitor client and competitor Yelp profiles. Track review velocity, rating changes, and response rates across locations.

Lead Generation Teams

Build prospect lists of local businesses filtered by category, location, rating, and price range. Export to CRM for outreach.

Reputation Management Services

Track review sentiment across multiple locations. Identify negative reviews requiring owner responses. Benchmark against competitors.

Market Researchers

Analyze business density, pricing, and customer satisfaction by geographic area. Identify market gaps and opportunities.

Restaurant & Hospitality Consultants

Benchmark menu pricing, customer satisfaction, and service quality across competitor locations.

Citation Building Services

Gather NAP data (Name, Address, Phone) for local SEO citation audits and consistency checks across platforms.

Quick Start

Demo Mode (Free Test)

{
  "demoMode": true
}

Scrape a Specific Business

{
  "scrapeType": "business_profile",
  "businessUrl": "https://www.yelp.com/biz/blue-bottle-coffee-san-francisco",
  "includeReviews": true,
  "includePhotos": true,
  "demoMode": false
}

Search for Businesses

{
  "scrapeType": "search",
  "searchTerm": "Pizza",
  "location": "New York, NY",
  "minRating": 4.0,
  "maxResults": 50,
  "demoMode": false
}

Filter by Category and Price

{
  "scrapeType": "search",
  "searchTerm": "Italian Restaurant",
  "location": "Los Angeles, CA",
  "priceRange": [2, 3],
  "categories": ["Italian", "Pizza"],
  "openNow": true,
  "demoMode": false
}

No login required! This scraper works with public Yelp data.

Input Parameters

Parameter	Type	Default	Description
scrapeType	string	search	Type: business_profile, search, reviews
businessUrl	string	-	Direct Yelp business URL
searchTerm	string	-	Business name or category to search
location	string	-	City/state or ZIP code
categories	array	-	Filter by Yelp categories
priceRange	array	-	Filter by price (1=$ to 4=$$$$)
minRating	number	-	Minimum star rating (1.0-5.0)
openNow	boolean	false	Only currently open businesses
includeReviews	boolean	true	Scrape customer reviews
maxReviewsPerBusiness	number	20	Max reviews per business
includePhotos	boolean	false	Extract photo URLs
maxResults	number	50	Maximum businesses to scrape
sortBy	string	best_match	Sort: best_match, rating, review_count, distance
proxyConfiguration	object	-	Proxy settings
demoMode	boolean	true	Return sample data for testing
webhookUrl	string	-	Webhook URL for results delivery

Output Format

{
  "businessName": "Mario's Italian Kitchen",
  "yelpUrl": "https://www.yelp.com/biz/marios-italian-kitchen-los-angeles",
  "yelpId": "marios-italian-kitchen-los-angeles",
  "rating": 4.5,
  "reviewCount": 847,
  "priceRange": "$$",
  "categories": ["Italian", "Pizza", "Pasta Shops"],
  "address": {
    "street": "456 Oak Avenue",
    "city": "Los Angeles",
    "state": "CA",
    "zip": "90001"
  },
  "coordinates": {
    "latitude": 34.0522,
    "longitude": -118.2437
  },
  "phone": "(323) 555-9876",
  "website": "https://mariositalian.com",
  "hours": {
    "monday": "11:00 AM - 10:00 PM",
    "tuesday": "11:00 AM - 10:00 PM",
    "wednesday": "11:00 AM - 10:00 PM",
    "thursday": "11:00 AM - 10:00 PM",
    "friday": "11:00 AM - 11:00 PM",
    "saturday": "10:00 AM - 11:00 PM",
    "sunday": "10:00 AM - 9:00 PM"
  },
  "attributes": {
    "delivery": true,
    "takeout": true,
    "reservations": true,
    "outdoorSeating": true,
    "parking": "Street",
    "wifi": "Free",
    "goodForGroups": true,
    "goodForKids": true
  },
  "photos": [
    "https://s3-media0.fl.yelpcdn.com/bphoto/abc123/o.jpg"
  ],
  "reviews": [
    {
      "reviewId": "rev123",
      "rating": 5,
      "text": "Best Italian food in LA! The pasta is made fresh daily...",
      "author": "John D.",
      "isElite": true,
      "date": "2026-01-15",
      "useful": 12,
      "funny": 2,
      "cool": 5,
      "ownerResponse": "Thank you for the kind words, John!"
    }
  ],
  "scrapedAt": "2026-01-28T10:30:00.000Z"
}

Pricing (Pay-Per-Event)

Event	Description	Price
business_scraped	Per business profile scraped	$0.02
review_scraped	Per review extracted	$0.002
photo_scraped	Per photo URL extracted	$0.001

Example costs:

• 50 businesses with 20 reviews each: (50 x $0.02) + (1000 x $0.002) = $3.00
• 100 businesses, profiles only: 100 x $0.02 = $2.00
• 25 businesses with photos: (25 x $0.02) + (250 x $0.001) = $0.75
• Demo mode: $0.00

Common Scenarios

Scenario 1: Competitor Reputation Analysis

{
  "scrapeType": "search",
  "searchTerm": "Italian Restaurant",
  "location": "San Francisco, CA",
  "minRating": 4.0,
  "sortBy": "review_count",
  "maxResults": 50,
  "includeReviews": true,
  "maxReviewsPerBusiness": 10,
  "demoMode": false
}

Compare top-rated competitors by review sentiment and volume.

Scenario 2: Lead Generation by Category

{
  "scrapeType": "search",
  "searchTerm": "Plumber",
  "location": "Houston, TX",
  "maxResults": 100,
  "includeReviews": false,
  "demoMode": false
}

Build prospect lists of local service businesses for outreach.

Scenario 3: Multi-Location Reputation Monitoring

{
  "scrapeType": "business_profile",
  "businessUrl": "https://www.yelp.com/biz/your-business-location-1",
  "includeReviews": true,
  "maxReviewsPerBusiness": 50,
  "demoMode": false
}

Track your own Yelp profile - schedule weekly to monitor changes.

Scenario 4: Market Gap Analysis

{
  "scrapeType": "search",
  "searchTerm": "Vegan Restaurant",
  "location": "Austin, TX",
  "sortBy": "rating",
  "maxResults": 100,
  "demoMode": false
}

Identify underserved markets by analyzing business density and ratings.

Webhook & Automation Integration

Webhook Configuration

{
  "scrapeType": "search",
  "searchTerm": "Restaurant",
  "location": "Miami, FL",
  "maxResults": 50,
  "webhookUrl": "https://your-endpoint.com/webhook"
}

Zapier Integration

1. Create a Zapier Webhook trigger (Catch Hook)
2. Copy the webhook URL to webhookUrl
3. Route results to Google Sheets, CRM, Slack, etc.

Popular Zaps:

• Yelp data -> Google Sheets (prospect database)
• Low-rated businesses -> Slack alert (reputation monitoring)
• Results -> HubSpot CRM (enrich leads with review data)
• New reviews detected -> Email notification

Make.com (Integromat)

1. Create a Webhooks module (Custom webhook)
2. Add webhook URL to configuration
3. Process results with Make.com scenarios

Popular Scenarios:

• Parse reviews and run sentiment analysis
• Auto-update reputation dashboard
• Trigger alerts on rating drops

n8n Integration

1. Add a Webhook node
2. Configure with webhook URL
3. Chain with processing nodes (filter, transform, store)

Apify Scheduled Runs

Schedule daily or weekly runs in Apify Console for ongoing monitoring. Use Apify webhooks or API for programmatic access.

Official API Alternatives

Yelp Fusion API

Yelp offers an official API with a free tier:

• Pros: Official, reliable, 5,000 API calls/day free, structured data
• Cons: No review text in free tier, rate limits, requires API key
• Best for: Applications needing real-time search with official support

This Scraper's Advantages

1. Full review text - Yelp API doesn't include review text in free tier
2. No API key management needed
3. Business attributes (hours, parking, amenities) in every result
4. Photo URLs included
5. Owner responses captured with reviews
6. No daily API call limits - pay per result
7. Works immediately without developer account setup

When to Use the Official API

• Real-time search in production applications
• You need Yelp's official Terms of Service compliance
• Daily API call volume is under 5,000 requests

FAQ

Q: Do I need a Yelp account?

A: No. This scraper uses public Yelp data. No login required.

Q: Why are some reviews missing?

A: Yelp filters reviews using their recommendation algorithm. Some reviews are hidden by Yelp and not publicly accessible. The scraper extracts all publicly visible reviews.

Q: Can I get owner/business responses to reviews?

A: Yes. When a business owner has responded to a review, the response text is captured in the ownerResponse field.

Q: How is this different from the Yelp Fusion API?

A: The Yelp Fusion API free tier doesn't include review text. This scraper includes full review text, owner responses, photos, and all business attributes for $0.02 per business.

Q: Can I filter by "Open Now"?

A: Yes. Set openNow: true to only return businesses that are currently open.

Q: How fresh is the data?

A: Data is scraped in real-time from Yelp's current listings. Reviews and ratings reflect the live state of each profile.

Common Problems & Solutions

"Business not found"

• Verify the URL format: https://www.yelp.com/biz/business-name-city
• Search for the business on yelp.com first and copy the URL
• Business may have been removed from Yelp

"No results" for search

• Broaden search term (e.g., "Restaurant" instead of "Vegan Thai Restaurant")
• Check location spelling (e.g., "San Francisco, CA")
• Remove filters (minRating, priceRange) temporarily

"Reviews seem limited"

• Yelp limits public review visibility
• Increase maxReviewsPerBusiness (default is 20)
• Some reviews are filtered by Yelp's recommendation algorithm

"Rate limited"

• Wait a few minutes between runs
• Reduce maxResults to smaller batches
• The actor uses anti-detection automatically

"Demo data showing"

• Set demoMode: false
• No API key or login required for real scraping

---

📞 Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal