Yelp Reviews Scraper

Yelp Reviews Actor

Introduction

The Yelp Reviews Actor is an Apify Actor that scrapes customer reviews from Yelp business pages. Provide one or more Yelp URLs along with proxy settings, and receive a structured JSON array containing detailed review data.

---

Input Parameters

Parameter	Type	Required	Description
proxyConfiguration	object	Yes	Proxy settings to avoid IP blocks and ensure reliable scraping.
└─ useApifyProxy	boolean	Yes	Whether to route requests through Apify Proxy.
└─ apifyProxyGroups	string[]	No	List of Apify Proxy groups to use (e.g., ["RESIDENTIAL"]).
urls	string[]	Yes	Array of Yelp business page URLs to scrape reviews from.

Example Input

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "urls": [
    "https://www.yelp.com/biz/marigold-event-space-san-francisco"
  ]
}

---

Features

• Configurable Proxy Support – Built‑in Apify Proxy integration to bypass rate limits and geo‑blocks.
• Batch URL Processing – Scrape reviews from multiple Yelp business pages in a single run.
• Comprehensive Review Data – Extracts review text, rating, author info, timestamps, business metadata, and reaction counts.
• Structured JSON Output – Consistent schema for seamless downstream processing.
• Robust Error Handling – Automatic retries on transient network or parsing errors.

---

Output

The Actor returns a JSON array where each element represents one review:

[
  {
    "review_id": "skXUG8ReCU9b-Uyk15eCKA",
    "text": "We held a 75th birthday party at Marigold last weekend. This is a great space in a great location! ...",
    "language": "en",
    "rating": 5,
    "author_name": "Uday W.",
    "author_location": "Bethesda, MD",
    "created_date": "2024-11-27T19:46:23-08:00",
    "business_name": "Marigold Event Space",
    "business_id": "ryksewO966EFX7Y5x4BRbA",
    "reactions": {
      "helpful": 0,
      "thanks": 0,
      "love_this": 0,
      "oh_no": 0
    }
  },
  {
    "review_id": "J1yvc19YBqCUwCtUi0YfKQ",
    "text": "We hosted my husband's 50th birthday party at the Marigold Event Space ...",
    "language": "en",
    "rating": 5,
    "author_name": "Lindsay B.",
    "author_location": "Mid-City, Los Angeles, CA",
    "created_date": "2025-04-08T14:35:20-07:00",
    "business_name": "Marigold Event Space",
    "business_id": "ryksewO966EFX7Y5x4BRbA",
    "reactions": {
      "helpful": 1,
      "thanks": 0,
      "love_this": 0,
      "oh_no": 0
    }
  }
]

---

Possible Use Cases

• Sentiment Analysis on customer feedback to identify areas for improvement.
• Competitor Benchmarking by comparing review counts and ratings across businesses.
• Market Research to gauge customer satisfaction trends by location or category.
• Customer Support Automation by flagging negative reviews for follow‑up.
• Data Aggregation for dashboards, reports, or machine‑learning models.

---

Support

For bug reports or custom needs, contact: 📧 support@getdataforme.com Or use our contact form: https://getdataforme.com/contact/