🔥 Yelp Scraper

Extract comprehensive business data from Yelp. Scrape specific business pages, collections, and events to gather detailed information including ratings, reviews, photos, menus, and more.

✨ Key Features

• 📊 Extract detailed business metadata including:
  • Business identification and contact information
  • Address, coordinates, and location details
  • Ratings, reviews, and customer feedback
  • Photos and media galleries
  • Operating hours and amenities
  • Menus and reservation links
  • Business categories and descriptions
• 🔗 Generate direct URLs for:
  • Business profiles
  • Review pages
  • Event pages
  • Collection pages
• 📈 Support for large result sets with automatic pagination
• 📋 Clean and structured JSON output
• 🎯 Flexible scraping options for reviews and photos

💪 Why Choose This Actor?

• Comprehensive: Get all business details from Yelp
• Flexible: Multiple input methods (keyword search, location search, or direct URLs)
• Efficient: Control pagination and item limits
• Structured: Clean JSON output for easy integration
• Reliable: Stable and consistent data extraction
• User-Friendly: Simple input parameters

🎯 Perfect For

• 📊 Market Researchers
• 📈 Business Analysts
• 💼 Competitor Analysts
• 🏢 Lead Generation
• 🔍 Local Business Discovery
• 📋 Review Analysis

📈 Use Cases

1. Market Research: Analyze business performance and customer reviews
2. Competitor Analysis: Monitor competitor's business profiles and ratings
3. Lead Generation: Collect business contact information
4. Review Analysis: Gather customer feedback and ratings
5. Local Business Discovery: Find businesses by location and category

📝 Input Requirements

The actor accepts the following input parameters:

• startUrls : URLs to start with. It should be list or detail URL (business detail, event detail, event or business search, collections, or collection detail URLs)
• itemLimit (optional): Maximum number of items that you want as output. Default is all
• proxySettings (required): Select proxies to be used by your crawler

Input Example

{
  "startUrls": [
    "https://www.yelp.com/biz/fermentation-lab-san-francisco-3"
  ],
  "itemLimit": 20,
  "proxySettings": {
    "useApifyProxy": true
  }
}

Output Example

{
  "businessIdentifier": "kLxPWEH56lLeXoNFJyS8HA",
  "itemType": "business",
  "businessUrl": "https://www.yelp.com/biz/fermentation-lab-san-francisco-3",
  "businessName": "Fermentation Lab",
  "averageRating": 4.4,
  "totalReviews": 254,
  "priceCategory": "$$",
  "businessCategories": [
    "Cocktail Bars",
    "Seafood",
    "Asian Fusion"
  ],
  "isClaimed": true,
  "isClosed": false,
  "establishedYear": null,
  "businessHistory": null,
  "locationAddress": {
    "city": "San Francisco",
    "regionCode": "CA",
    "addressLine1": "1700A Post St",
    "addressLine2": null,
    "addressLine3": "",
    "postalCode": "94115",
    "formatted": "1700A Post St\nSan Francisco, CA 94115"
  },
  "locationCoordinates": [
    {
      "latitude": 37.785693,
      "longitude": -122.430047
    }
  ],
  "businessHighlights": [],
  "mainPhotoUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/3ziKJn2hbY7jgOq5Pu1GtQ/o.jpg",
  "customerReviews": [
    {
      "userName": "Ethel R.",
      "userUrl": "https://www.yelp.com/user_details?userid=cM8RhSU69PSoLmMAv1fRXQ",
      "isElite": false,
      "rating": 5,
      "date": "2026-01-17T01:40:31.000Z",
      "review": "Perfect place to go after a long work week.  Always great drinks and amazing food.\n\nFermentation Lab\n@fermlabsf_japantown\n\nHappy Hour\nTue-Sat 3.30pm to 6.00pm\nSun 3.30pm to Close\n\nPinot Noir\n\nFresh Oyster\nAsian Pear & Sherry Wine Granita\n\nThe set seating and decor makes you feel so relax.  You feel so welcome from the staff.",
      "reviewLanguage": "en",
      "reviewLink": "https://www.yelp.com/biz/fermentation-lab-san-francisco-3?hrid=kFEkHvDrviZeWWBzjBXqKA",
      "author": {
        "id": "cM8RhSU69PSoLmMAv1fRXQ",
        "name": "Ethel R.",
        "location": "San Francisco, CA",
        "photoUrls": {
          "mediaItemSrcUrl": "https://s3-media0.fl.yelpcdn.com/photo/IZi3m6OfCYUvO4GgdZmctw/30s.jpg",
          "mediaItemSrcSetUrl200x": "https://s3-media0.fl.yelpcdn.com/photo/IZi3m6OfCYUvO4GgdZmctw/60s.jpg",
          "mediaItemSrcSetUrl300x": "https://s3-media0.fl.yelpcdn.com/photo/IZi3m6OfCYUvO4GgdZmctw/90s.jpg",
          "__typename": "UserPhotoUrl",
          "userSrc": "https://s3-media0.fl.yelpcdn.com/photo/IZi3m6OfCYUvO4GgdZmctw/60s.jpg",
          "userSrcSet200x": "https://s3-media0.fl.yelpcdn.com/photo/IZi3m6OfCYUvO4GgdZmctw/120s.jpg",
          "userSrcSet300x": "https://s3-media0.fl.yelpcdn.com/photo/IZi3m6OfCYUvO4GgdZmctw/180s.jpg"
        },
        "friendCount": 16,
        "reviewCount": 32,
        "businessPhotoCount": 205,
        "isElite": false
      },
      "feedback": {
        "usefulCount": 0,
        "funnyCount": 0,
        "coolCount": 0
      }
    },
    ...
  ],
  "businessWebsite": "http://www.fermlabsf.com",
  "contactPhone": "(415) 757-0667",
  "reservationLink": null,
  "totalMediaCount": 981,
  "mediaUrls": [],
  "sourceUrl": "https://www.yelp.com/biz/fermentation-lab-san-francisco-3"
}