Yelp Business Reviews Scraper ⭐

⭐ One page record with up to ten public reviews

For reputation teams, restaurant managers and researchers

🔎 What is the Yelp Business Reviews Scraper — and when should you use it?

The Yelp Business Reviews Scraper turns a 22-character Yelp business ID and a review page number into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

Use it when you need: review text, ratings, dates, public author details and available photos or owner replies from a known Yelp business.

Use something else when: you need business discovery, business profiles or exhaustive review history. This actor retrieves one review page. It does not search for businesses or promise exhaustive history.

🤖 Use with AI agents

Already connected to the Apify MCP server? Just ask for this Actor by name: sian.agency/yelp-business-reviews-scraper

Agentic payments: Availability of x402 and Skyfire depends on this Actor's current Store eligibility. Check the published listing for supported payment methods. One completed review page is one page event, including a valid empty page. Failed retrievals have no review-page charge. A separate run-start fee applies.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

I want public review-page exports for reputation reporting and customer research using the Apify Actor `sian.agency/yelp-business-reviews-scraper`.

Use it when I need: review text, ratings, dates, public author details and available photos or owner replies from a known Yelp business.

Don't use it when: This actor retrieves one review page. It does not search for businesses or promise exhaustive history.

How to call it: set operation to reviews, supply businessId, and choose page. Read the full reviews array in the output record.

Start with this input:
{
  "operation": "reviews",
  "businessId": "TRBP1G1l8vZkjgfqdx96Cw",
  "page": 1
}

Ask me which 22-character Yelp business ID and page they want, then run the Actor and summarise the results as a table.

Things you can ask your agent for:

• Export the first review page for this Yelp business and show ratings alongside the text.
• Retrieve page two for this business and preserve the public author details.
• Save this review-page snapshot to JSON for my reputation report.

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at apify.com/sian.agency/yelp-business-reviews-scraper.md.

📋 Overview

Export a known Yelp business’s public review page with its text, ratings, dates and author details. Each page stays together in one record. JSON preserves photos, owner replies and previous reviews when they are available.

• ⭐ Complete pages: every returned review stays in the reviews array.
• 📄 Page selection: page 2 was verified to return different reviews from page 1.
• 📝 Text previews: page-level fields make the first review easy to inspect.
• 💰 Clear billing: one completed page event; no extra per-review charge.
• 📊 Export choices: download JSON, CSV or Excel from Apify.
• 📄 Processing report: see page counts and accepted charges after the run.

✨ Features

• 🏪 Business ID: use an existing 22-character Yelp business ID.
• 📄 One page per run: select a page from 1 to 100, subject to availability.
• 💬 Review text: retain the available review body without generating a summary.
• ⭐ Ratings: keep each review’s numeric score.
• 👤 Authors: preserve public author names and profile details when returned.
• 📸 Photos and replies: nested review information remains in JSON.
• 🕒 Retrieval date: distinguish the review’s date from the export timestamp.

🎬 Quick Start

Open the actor in Apify Console and use the prefilled business ID. Choose page 1 and press Start. Open the dataset to inspect the reviews array, or download JSON for nested fields.

{
  "operation": "reviews",
  "businessId": "TRBP1G1l8vZkjgfqdx96Cw",
  "page": 1
}

🚀 Getting Started

Step 1: Choose a business

Supply an existing 22-character Yelp business ID. Business URL aliases are not supported, and this actor cannot discover the ID for you.

Step 2: Choose a page

Start with page 1. Every run retrieves one page with up to ten reviews.

Step 3: Read and export

Open the page record and its reviews array. Use JSON when you need full photo, reply and author details.

📥 Input Configuration

Field	Type	Meaning
operation	string	reviews
businessId	string	Existing 22-character Yelp business ID
page	integer	One page, 1–100; default 1

The business field has a ready-to-test prefill. API calls must supply their own businessId. There is no business-search or automatic multi-page mode.

📤 Output

Field	Type	Meaning
businessId	string	Requested 22-character business ID
page	integer	Requested page
reviewCount	integer	Number of reviews returned
reviews	array	Full returned reviews with available nested fields
topReviewText	string/null	First review’s text
topReviewRating	number/null	First review’s rating
topReviewDate	string/null	First review’s date
topAuthor	string/null	First author’s public name
processedAt	string	ISO 8601 processing timestamp
scrapingDate	string	UTC processing date (YYYY-MM-DD)
status	string	Record status

A review inside the array can include review_id, review_rating, review_text, review_datetime_utc, author_name, review_photos, business_owner_replies and previous_reviews_by_author. Available fields vary.

{"businessId":"TRBP1G1l8vZkjgfqdx96Cw","page":1,"reviewCount":10,"reviews":[{"review_rating":5,"review_text":"The Food is Amazing! Awesome burgers just how you want, the fries are fresh and Hot!"}],"status":"success"}

The example abbreviates the reviews array and review text. The actual record preserves every returned review.

💼 Use Cases & Examples

1. Restaurant feedback review

Restaurant managers can export the first page for a known business ID and read the feedback alongside its ratings. JSON keeps the full returned page together.

2. Reputation reporting

Agencies can attach a dated review-page snapshot to a client report. Use the existing business ID; this actor does not find it for you.

3. Customer research

Researchers can inspect the review text for phrases customers use. Check the original review before quoting its author.

4. Rating audits

Analysts can compare a review’s score with its text and public date. Each review remains a separate object inside the page record.

5. Research archives

Save a page with its retrieval date so your team knows when it was collected. Reviews may be edited or removed later.

6. Workflow exports

Developers can pass the complete reviews array into their own database or analysis step. JSON preserves nested photos and replies.

🔗 Integration Examples

JavaScript

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('sian.agency/yelp-business-reviews-scraper').call({"operation": "reviews", "businessId": "TRBP1G1l8vZkjgfqdx96Cw", "page": 1});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].reviews);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('sian.agency/yelp-business-reviews-scraper').call(run_input={"operation": "reviews", "businessId": "TRBP1G1l8vZkjgfqdx96Cw", "page": 1})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item['reviews'])

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~yelp-business-reviews-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' -d '{"operation": "reviews", "businessId": "TRBP1G1l8vZkjgfqdx96Cw", "page": 1}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger the workflow on a schedule or with a supplied business ID.
2. Start the actor using an HTTP request.
3. Wait for the run and read the dataset.
4. Save the page record to your spreadsheet or database.

📊 Performance & Pricing

Each completed page produces one record and one review-page event. A valid page with zero reviews is still a completed retrieval. Failed retrievals have no review-page charge. The separate run-start fee applies even when input is invalid or the run stops early.

Apify plan	Per completed page	Run start
Free	$0.57144	$0.020
Bronze	$0.14286	$0.005
Silver	$0.13429	$0.005
Gold	$0.12572	$0.005

Enterprise customers should check their live quote. Prices are per page, rather than per individual review. One page is retrieved per run on every plan. Processing time and coverage vary; no speed or complete-history guarantee is offered.

Check current pricing.

❓ Frequently Asked Questions

How is a page billed?

One completed page is one review-page event, including a valid empty page. Failed retrievals have no review-page charge. A separate run-start fee applies.

Does this find businesses?

No. Supply an existing 22-character Yelp business ID. This actor does not discover IDs.

How many reviews does a page contain?

Up to ten. The returned reviews array contains every review from that page, including available author details, photos and owner replies.

Can I retrieve page two?

Yes. Set page to 2. One page is retrieved per run; pagination and complete history depend on availability.

Are all businesses covered?

No. A valid business may be unavailable. Check the business ID and retry once later if necessary.

Can I export the text?

Yes. JSON preserves nested reviews and photos. CSV and Excel keep the page-level fields alongside the reviews array.

🐛 Troubleshooting

The business could not be retrieved

Check that you supplied a 22-character business ID rather than a URL alias. Some valid businesses are unavailable; retry that business later.

The page has no reviews

Try an earlier page. A completed empty review page is billed once. There is no promise that page 100 exists for every business.

The run stopped before retrieval

Check your run budget and account credits. Free API-origin runs are restricted; use Console or MCP for evaluation.

Nested fields look compressed in CSV

Download JSON to preserve reviews, photos, replies and previous reviews as nested data.

⚖️ Legal Disclaimer

Yelp is a trademark of Yelp Inc. SIÁN Agency is independent and is not endorsed by Yelp. Public reviews can include personal data, including author names and locations. Check your purpose and applicable rules, including GDPR, before storing or sharing the results.

Read Apify’s web scraping legal guide for background. You are responsible for your use of exported reviews.

🤝 Support

Open an issue with the business ID, page and run link. Avoid posting account tokens or private customer data.

Email apify@sian-agency.online. See more tools in the SIÁN Agency Store.

Built by SIÁN Agency