# Yelp Reviews Scraper — Ratings, Text & Insights (`intelscrape/yelp-reviews-scraper`) Actor

Pull public Yelp business reviews — stars, text, dates, authors. Optional paid review-summary + review-insights per business. Paste yelp.com/biz URLs. Pay per review.

- **URL**: https://apify.com/intelscrape/yelp-reviews-scraper.md
- **Developed by:** [IntelScrape](https://apify.com/intelscrape) (community)
- **Categories:** Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 reviews

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Yelp Reviews Scraper – Star Ratings Review Text & Authors

![Actor Banner](https://api.apify.com/v2/key-value-stores/PyvJzfQg02FD3RYhd/records/yelp-reviews-scraper-banner.png)

> 🇨🇳 **中文简介 (Chinese — China & Singapore):**
> 需要批量抓取 Yelp 公开商家评论？本 Actor 从 yelp.com/biz 页面提取星级、评论文本、日期与作者昵称，按交付评论条数计费，无需自备 API Key——适合品牌声誉、本地服务拓客与竞品研究团队。立刻在 Apify 试跑，把评论数据导入表格、CRM 或 Claude / Cursor。

> 🇸🇬 **Ringkasan Melayu (Singapore):**
> Perlukan ulasan awam Yelp dengan pantas? Actor ini ekstrak rating bintang, teks ulasan, tarikh dan nama pengarang dari halaman yelp.com/biz. Bayar hanya untuk setiap ulasan yang dihantar; tiada API key. Sesuai untuk pasukan reputasi jenama dan penyelidikan di Singapura. Cuba di Apify Store hari ini.

#### 🤖 NEW: Connect This To Your AI!

Want to use this scraper directly inside Claude, Cursor, or ChatGPT? Check out **[Skip Trace MCP Server](https://apify.com/intelscrape/skip--trace)**. Combined IntelScrape agents over Model Context Protocol — autonomous leads, enrichment, outreach prep.

#### 🏆 Featured Bots by IntelScrape

1. **[Yelp Reviews Scraper](https://apify.com/intelscrape/yelp-reviews-scraper)** — Star Ratings, Review Text & Authors
2. **[Skip Trace PRO](https://apify.com/intelscrape/skip-trace-pro)** — Name, Address, Phone & Email People Lookup
3. **[TruePeopleSearch Scraper](https://apify.com/intelscrape/truepeoplesearch-scraper)** — Phone & Email Matches
4. **[TikTok Scraper](https://apify.com/intelscrape/tiktok-scraper)** — Emails & Influencer Leads
5. **[Amazon Product Review Scraper](https://apify.com/intelscrape/amazon-product-review-scraper)** — Deep E-commerce & Review Extraction
6. **[Building Permit Scraper](https://apify.com/intelscrape/building-permit-scraper)** — US Cities Open Data
7. **[Google Maps No-Website Leads](https://apify.com/intelscrape/website-Leads)** — Local Businesses Without a Website
8. **[Skip Trace MCP Server](https://apify.com/intelscrape/skip--trace)** — Use IntelScrape inside Claude, Cursor, ChatGPT

***

⚡ **Use this Actor in n8n — no code**

1. Add the official **Apify** node in n8n.
2. Connect your Apify API token.
3. Run Actor ID: `IntelScrape/yelp-reviews-scraper`.

***

![price](https://img.shields.io/badge/price-$1.00_/_1K-e83e8c)
![billing](https://img.shields.io/badge/billing-pay_per_review-2ea44f)
![API key](https://img.shields.io/badge/API_key-not_required-blue)
![coverage](https://img.shields.io/badge/coverage-Yelp.com_US-8a2be2)
![demo](https://img.shields.io/badge/demoMode-fixtures_included-informational)

**Yelp Reviews Scraper** — clean public-page extraction with honest pay-per-result billing.\
**≈ $$1.00/1K + $0.005 actor start. No API key required.**

> **Honest coverage & billing (read this):** Source is **public Yelp business pages** only — not the Yelp Fusion API and not private messages. Billed **$0.005** actor start + **$0.001** per delivered review (`apify-default-dataset-item`) + optional **$0.01** `review-summary` and **$0.01** `review-insights` per business when those toggles are on (default). Empty parses are not billed as reviews. `demoMode` pushes fictional fixtures.

***

> 🧭 Built for **brand reputation, local SEO, agency review monitoring, and competitor research teams.** Popular with teams in the **US, China, and Singapore**.

> ⭐ **Store rating is driven by daily power users.** If this Actor saves you time, please [leave a review](https://apify.com/intelscrape/yelp-reviews-scraper).

> ⚖️ **Lawful business use only.** Public pages only. You are liable for how you use the data.

> 📌 *Examples in this README are **fictional** unless stated otherwise.*

***

### Paid review insights

When `includeReviewInsights` is on (default), each successful run appends one `review-insights` row **per business** (rating breakdown, ranked complaint themes with severity, top negative terms from 1–2★ reviews, request snippets) and charges **`review-insights` $0.01**/business. Deterministic extractive analytics — **no external LLM**. SoftCTA mesh is retained on insights **and each review row** (Google/Trustpilot/Glassdoor/BBB · Maps Email / Website Leads / Contact / B2B / Email Finder / Phone · Facebook Ads · Amazon Product Review · TruePeopleSearch / Skip Trace PRO). SoftCTA only — no extra PPE. 

### Paid review summary + SoftCTA

When `includeReviewSummary` is on (default), each successful run appends one `reviews-batch-summary` row **per business** (avg stars, star histogram, SoftCTA mesh) and charges **`review-summary` $0.01**/business (Trustpilot parity). The summary row also bills as a normal dataset item.

### Soft CTA — next steps after reviews

SoftCTA mesh deepened 7→14 on **each review row**, `reviews-batch-summary`, and `review-insights` (SoftCTA only — no extra PPE) — brand/contact/reviews/ads/people parity with trustpilot SoftCTA deepen 1.0.21:

- [Google Reviews Scraper](https://apify.com/intelscrape/google-reviews-scraper-the-best)
- [Trustpilot Reviews Scraper](https://apify.com/intelscrape/trustpilot-reviews-scraper)
- [Glassdoor Reviews Scraper](https://apify.com/intelscrape/glassdoor-reviews-scraper)
- [BBB Business Directory Scraper](https://apify.com/intelscrape/bbb-business-directory-scraper)
- [Google Maps Email Extractor](https://apify.com/intelscrape/google-maps-email-extractor)
- [Website Leads](https://apify.com/intelscrape/website-Leads)
- [Contact Info Scraper](https://apify.com/intelscrape/contact-info-scraper)
- [B2B Lead Generator](https://apify.com/intelscrape/b2b-lead-generator)
- [Email Finder Verified](https://apify.com/intelscrape/email-finder-verified)
- [Phone Number Validator](https://apify.com/intelscrape/phone-number-validator)
- [Facebook Ads Library Scraper](https://apify.com/intelscrape/facebook-scraper)
- [Amazon Product Review Scraper](https://apify.com/intelscrape/amazon-product-review-scraper)
- [TruePeopleSearch Scraper](https://apify.com/intelscrape/truepeoplesearch-scraper)
- [Skip Trace PRO](https://apify.com/intelscrape/skip-trace-pro)

### 🕵️‍♂️ Why Choose Us vs. "Cheaper" Competitors?

| Feature | Yelp Reviews Scraper (IntelScrape) | Thin scrapers |
| :--- | :--- | :--- |
| **Input** | `yelp.com/biz/…` URLs | Guesswork HTML dumps |
| **Billing** | Pay per delivered review | Rent-days / empty rows |
| **Fields** | Stars, text, date, author | Partial undocumented |
| **Review summary** | Paid `review-summary` per business (avg/histogram/SoftCTA) | Often missing |
| **Review insights** | Paid `review-insights` per business (themes/neg terms/requests) | Often missing / LLM-priced |

***

### Quick start

```json
{
  "businessUrls": ["https://www.yelp.com/biz/tartine-bakery-san-francisco"],
  "maxReviews": 50,
  "demoMode": false
}
```

**Demo (fictional fixtures):**

```json
{ "demoMode": true }
```

***

### What you get

- `reviewId`
- `businessName`
- `businessUrl`
- `rating`
- `text`
- `date`
- `authorName`
- `source`

***

### Pricing (PPE — live)

| Event | Price | When it fires |
| :--- | ---: | :--- |
| Actor start (`apify-actor-start`) | **$0.005** | Once per run |
| Review (`apify-default-dataset-item`) | **$0.001** | Each delivered row via `pushData` |

***

### Legal

Public pages only. Not affiliated with the source sites. Lawful B2B / research use; you are responsible for compliance. Demo content is fictional.

# Actor input Schema

## `businessUrls` (type: `array`):

Full yelp.com/biz/... URLs.

## `startUrls` (type: `array`):

Alternate list of Yelp business URLs (request list).

## `maxReviews` (type: `integer`):

Maximum reviews to push across all business URLs.

## `demoMode` (type: `boolean`):

Push synthetic fixtures (no live scrape). Use for Store smoke / PPE tests.

## `encBizIds` (type: `array`):

Optional 22-char Yelp encBizIds (from meta yelp-biz-id). Fastest path — skips HTML/DataDome.

## `includeReviewSummary` (type: `boolean`):

When true (default), push one reviews-batch-summary row per business (avg stars, histogram, SoftCTA) and charge review-summary PPE ($0.01/business). Trustpilot-parity analytics layer.

## `includeReviewInsights` (type: `boolean`):

When true (default), push one review-insights row per business (rating breakdown, ranked complaint themes with severity, top negative terms from 1–2★ reviews, request snippets) and charge review-insights PPE ($0.01/business). Deterministic — no external LLM. Trustpilot/memo23 parity.

## Actor input object example

```json
{
  "businessUrls": [
    "https://www.yelp.com/biz/joes-pizza-new-york-4"
  ],
  "maxReviews": 50,
  "demoMode": false,
  "includeReviewSummary": true,
  "includeReviewInsights": true
}
```

# Actor output Schema

## `reviews` (type: `string`):

Review rows pushed to the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "businessUrls": [
        "https://www.yelp.com/biz/joes-pizza-new-york-4"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("intelscrape/yelp-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "businessUrls": ["https://www.yelp.com/biz/joes-pizza-new-york-4"] }

# Run the Actor and wait for it to finish
run = client.actor("intelscrape/yelp-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "businessUrls": [
    "https://www.yelp.com/biz/joes-pizza-new-york-4"
  ]
}' |
apify call intelscrape/yelp-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,intelscrape/yelp-reviews-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nrIrjEb2sWg644eJL/builds/1qfNn3AFeNEe1miFS/openapi.json