Yelp Reviews Scraper

Extract public Yelp review data for one or many business pages. The actor collects reviews, ratings, reviewer metadata, owner replies, review URLs, and collection diagnostics so reputation teams can monitor Yelp feedback without manual copying.

Who is it for?

• Reputation-management agencies tracking review changes for client portfolios.
• Local chains monitoring customer feedback across branches.
• Market researchers comparing public sentiment across competitors.
• Data teams enriching dashboards, alerts, BI reports, and AI review-analysis workflows.

What can Yelp Reviews Scraper do?

• Scrape public reviews from Yelp business URLs, aliases, or dedicated business IDs.
• Limit the number of reviews per business to control cost and runtime.
• Sort reviews by newest, relevance, highest rating, or lowest rating.
• Filter by selected star ratings, language, or review search text.
• Preserve partial output when one business fails in a multi-business run.
• Redact direct reviewer profile URLs by default while keeping useful reviewer names and IDs.

Ready-to-run examples

Open these published examples from the Actor's Examples tab:

• Monitor the newest Yelp reviews for a business
• Find 1-star and 2-star Yelp reviews for a business
• Collect 5-star Yelp reviews for customer research
• Search Yelp reviews for service feedback
• Export English-language Yelp reviews to CSV or JSON
• Compare Yelp reviews across two businesses
• Build a Yelp reviews dataset for AI or RAG

Input example

{
  "startUrls": [
    { "url": "https://www.yelp.com/biz/gary-danko-san-francisco" },
    { "url": "bottega-louie-los-angeles" }
  ],
  "maxReviewsPerBusiness": 10,
  "sort": "DATE_DESC",
  "ratings": ["5", "4"],
  "language": "en",
  "reviewSearch": "service",
  "redactReviewerProfileUrls": true
}

Input settings

Field	Type	Description
startUrls	array	Yelp business URLs or Yelp aliases. Bare aliases are not treated as opaque IDs.
businessUrls	array	Additional Yelp business URLs or aliases.
businessIds	array	Optional dedicated field for opaque Yelp business IDs.
maxReviewsPerBusiness	integer	Maximum unique reviews to save for each business.
sort	string	DATE_DESC, RELEVANCE_DESC, RATING_DESC, or RATING_ASC.
ratings	array	Optional list of star ratings to include, such as ["5", "4"].
language	string	Optional language code such as en. Leave blank for Yelp default behavior.
reviewSearch	string	Optional keyword or phrase to search inside reviews.
redactReviewerProfileUrls	boolean	Omit direct reviewer profile URLs by default for privacy-conscious exports.

Output example

{
  "reviewId": "abc123",
  "reviewUrl": "https://www.yelp.com/biz/gary-danko-san-francisco?hrid=abc123",
  "businessId": "opaque-business-id",
  "businessAlias": "gary-danko-san-francisco",
  "businessName": "Gary Danko",
  "businessUrl": "https://www.yelp.com/biz/gary-danko-san-francisco",
  "rating": 5,
  "text": "Wonderful dinner and excellent service.",
  "language": "en",
  "createdAt": "2026-07-01T00:00:00.000Z",
  "createdAtLocal": "Jul 1, 2026",
  "reviewerId": "reviewer-id",
  "reviewerName": "A. Customer",
  "reviewerLocation": "San Francisco, CA",
  "reviewerProfileUrl": null,
  "ownerReplyText": "Thank you for visiting!",
  "ownerReplyCreatedAt": "2026-07-02T00:00:00.000Z",
  "mediaCount": 2,
  "reactions": { "useful": 1, "funny": 0, "cool": 0 },
  "sourceUrl": "https://www.yelp.com/biz/gary-danko-san-francisco",
  "collectedAt": "2026-07-31T00:00:00.000Z"
}

Output fields

Field	Description
reviewId	Yelp review identifier.
reviewUrl	Direct public review URL when available.
businessId	Yelp business identifier used by the run.
businessAlias	Public Yelp business alias.
businessName	Business name.
businessUrl	Public Yelp business page URL.
rating	Star rating from 1 to 5.
text	Review text.
language	Review language when available.
createdAt	Normalized review timestamp when available.
createdAtLocal	Yelp-displayed review date text.
reviewerId	Reviewer identifier when available.
reviewerName	Reviewer display name.
reviewerLocation	Reviewer location text.
reviewerProfileUrl	Reviewer profile URL only when URL redaction is disabled and available.
ownerReplyText	Public owner reply text when present.
ownerReplyCreatedAt	Owner reply timestamp when available.
mediaCount	Number of media items attached to the review when available.
reactions	Public reaction counts when available.
sourceUrl	Input/resolved business URL used for collection.
collectedAt	Timestamp when the item was saved.

Pricing

This actor uses pay-per-event pricing. See the live Pricing tab for the current rates.

• Start: a small one-time fee is charged when a run starts.
• Review saved: charged for each Yelp review item successfully saved to the dataset.

You can keep runs inexpensive by using a low maxReviewsPerBusiness, limiting the number of businesses per run, and applying rating or keyword filters only when they are needed.

Input recipes

Monitor newest reviews for one business

{
  "startUrls": [{ "url": "https://www.yelp.com/biz/gary-danko-san-francisco" }],
  "maxReviewsPerBusiness": 20,
  "sort": "DATE_DESC",
  "redactReviewerProfileUrls": true
}

Find low-rating feedback for a portfolio

{
  "startUrls": [
    { "url": "gary-danko-san-francisco" },
    { "url": "bottega-louie-los-angeles" }
  ],
  "maxReviewsPerBusiness": 50,
  "sort": "DATE_DESC",
  "ratings": ["1", "2"],
  "redactReviewerProfileUrls": true
}

Search reviews for a service topic

{
  "startUrls": [{ "url": "https://www.yelp.com/biz/gary-danko-san-francisco" }],
  "maxReviewsPerBusiness": 25,
  "reviewSearch": "service",
  "language": "en"
}

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/yelp-reviews-scraper').call({
  startUrls: [{ url: 'https://www.yelp.com/biz/gary-danko-san-francisco' }],
  maxReviewsPerBusiness: 10,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/yelp-reviews-scraper').call(run_input={
    'startUrls': [{'url': 'https://www.yelp.com/biz/gary-danko-san-francisco'}],
    'maxReviewsPerBusiness': 10,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

cURL

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~yelp-reviews-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"startUrls":[{"url":"https://www.yelp.com/biz/gary-danko-san-francisco"}],"maxReviewsPerBusiness":10}'

MCP and AI agent usage

Use the Apify MCP server with this actor to let AI agents request fresh Yelp review data:

https://mcp.apify.com/?tools=fetch_cat/yelp-reviews-scraper

Add the Apify MCP server to Claude Desktop or Claude Code with a command such as:

$claude mcp add apify https://mcp.apify.com/?tools=fetch_cat/yelp-reviews-scraper

MCP JSON configuration example:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=fetch_cat/yelp-reviews-scraper"
    }
  }
}

Example prompt ideas showing MCP usage:

• "Use Yelp Reviews Scraper to collect the newest 20 Yelp reviews for this business and summarize common complaints."
• "Run the actor for these Yelp business URLs and compare the latest low-star reviews across locations."
• "Export review text and ratings from Yelp Reviews Scraper for sentiment analysis."

Limits and troubleshooting

• Yelp may show fewer reviews than requested for businesses with limited public review history or tight filters.
• Some old review dates are only available as Yelp-displayed local date text.
• Multi-business runs continue after a failed business and save failure details to key-value records.
• For large portfolios, run smaller batches on a schedule to simplify monitoring and retries.
• If a run returns no items, test one known public business URL with a low review limit first.

FAQ

Can I scrape multiple Yelp businesses in one run?

Yes. Add multiple business URLs or aliases to startUrls. The actor keeps each output item tied to its source business.

Can I collect only one-star reviews?

Yes. Set ratings to ["1"] and choose the sort order that fits your workflow.

Does the actor return owner replies?

Yes, public owner reply text and reply timestamps are returned when Yelp provides them.

Can I use the output in dashboards or alerts?

Yes. Export the dataset as JSON, CSV, Excel, or consume it through the Apify API.

Does the actor include private Yelp data?

No. It extracts publicly available review data from business pages.

Related actors

• Google Maps Reviews Scraper
• Google Reviews Scraper
• Tripadvisor Reviews Scraper
• Trustpilot Reviews Scraper
• Facebook Reviews Scraper

Support

If you need help, open an issue on the actor page and include your input, run ID, and a short description of what you expected to receive.