Yelp Reviews Scraper

Extract public Yelp review data for one or many business pages. The actor collects clean review text, ratings, business context, photos, videos, reaction counts, reviewer metadata, owner replies, review URLs, and collection diagnostics for monitoring and analysis.

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.
• Export attached review photos and videos, legacy feedback counts, current Yelp reactions, and visit tags.
• Attach business rating, review count, primary photo, and rating/language distributions to every review.
• Preserve partial output when one business fails in a multi-business run.
• Keep reviewer profile URLs redacted and extended reviewer profile metrics disabled by default.

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,
  "includeReviewerDetails": false
}

Input settings

Output example

{
  "reviewId": "7byQK-mVsJdfCCb4MhzHYQ",
  "reviewPosition": 1,
  "reviewUrl": "https://www.yelp.com/biz/gary-danko-san-francisco?hrid=7byQK-mVsJdfCCb4MhzHYQ",
  "businessId": "WavvLdfdP6g8aZTtbBQHTw",
  "businessAlias": "gary-danko-san-francisco",
  "businessName": "Gary Danko",
  "businessUrl": "https://www.yelp.com/biz/gary-danko-san-francisco",
  "businessRating": 4.5,
  "businessReviewCount": 6133,
  "rating": 4,
  "text": "I've been to Gary Danko a few times over the years, and it continues to be one of San Francisco's classic fine dining restaurants.",
  "language": "en",
  "createdAt": "2026-07-31T05:31:29Z",
  "createdAtLocal": "2026-07-30T22:31:29-07:00",
  "reviewerName": "Johnny Z.",
  "reviewerProfileUrl": null,
  "reviewerReviewCount": null,
  "photos": [
    {
      "id": "KK2AtWft-qNmtAqAFZjgug",
      "url": "https://s3-media0.fl.yelpcdn.com/bphoto/KK2AtWft-qNmtAqAFZjgug/348s.jpg",
      "caption": null
    }
  ],
  "videos": [],
  "mediaCount": 10,
  "feedback": { "useful": 0, "funny": 0, "cool": 0 },
  "contentReactions": { "helpful": 0, "thanks": 0, "loveThis": 0, "ohNo": 0 },
  "ownerReply": null,
  "sourceUrl": "https://www.yelp.com/biz/gary-danko-san-francisco",
  "collectedAt": "2026-07-31T00:00:00.000Z"
}

This example is shortened for readability. Reviewer enrichment fields remain null unless includeReviewerDetails is enabled.

Common workflows

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.
• Extended reviewer profile metrics are disabled by default. Enable them only when your use case and retention policy require that personal data.
• 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.

Support

If a run fails or the output looks wrong, open an issue on the Actor page. Include the Apify run ID or run URL, input JSON, expected output, actual output, and one reproducible public Yelp business URL.