# Yelp Reviews Scraper (`api-ninja/yelp-reviews-scraper`) Actor ๐ŸŽ Scrape Yelp customer reviews from business URLs or IDs with sorting, rating filters, pagination, and resilient API retries. - **URL**: https://apify.com/api-ninja/yelp-reviews-scraper.md - **Developed by:** [API ninja](https://apify.com/api-ninja) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 10 total users, 9 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ### What is Yelp Reviews Scraper? **Yelp Reviews Scraper** extracts public customer reviews from [Yelp](https://www.yelp.com/) business pages and saves them as structured dataset items on Apify. Add one or more Yelp business URLs or Yelp business IDs, choose sorting and star-rating filters, and run the Actor to collect raw review data. This Actor is built for one focused task: **scraping Yelp reviews**. It does not search Yelp businesses, scrape business profiles, menus, or popular dishes. If you need the full Yelp data workflow, use [Yelp Ultimate Scraper](https://apify.com/api-ninja/yelp-ultimate-scraper). Because it runs on Apify, you also get platform features such as dataset exports, API access, scheduled runs, run monitoring, webhooks, integrations, and cloud storage. ### What can Yelp Reviews Scraper do? - ๐Ÿ’ฌ Scrape public Yelp reviews from one or many business profiles. - ๐Ÿ”— Accept Yelp `/biz/` URLs or 22-character Yelp business IDs. - โ†•๏ธ Sort reviews by Yelp default order, newest first, oldest first, highest rated, lowest rated, or elites. - โญ Filter reviews by all ratings or only 1-star, 2-star, 3-star, 4-star, or 5-star reviews. - ๐Ÿ“Š Limit reviews per business or scrape all available review pages. - ๐Ÿงพ Save raw review objects without extra metadata added by the Actor. - ๐Ÿ” Retry temporary API failures with exponential backoff. - ๐Ÿ“ฅ Export results from Apify datasets as JSON, CSV, Excel, HTML, XML, or RSS. - ๐Ÿ”Œ Automate review exports with Apify API, schedules, integrations, and webhooks. ### Why scrape Yelp reviews? Yelp reviews are useful for reputation monitoring, local competitor research, market analysis, location audits, and customer sentiment tracking. Agencies can monitor reviews for client locations, restaurant groups can compare customer feedback across branches, and analysts can collect structured review text for reporting or NLP workflows. This Actor is especially useful when you already know which Yelp businesses you want to monitor. You can paste direct business URLs, choose the review filter, and run without configuring broader Yelp search settings. ### What Yelp review data can you extract? The dataset view highlights the most useful fields from each raw review object. The **All fields** view keeps the full raw JSON returned by the API. | Field | Description | | -------------------------------------- | ---------------------------------------- | | `encid` | Raw Yelp review ID | | `rating` | Star rating for the review | | `reviewCreatedAt` | Review publication date | | `text.full` | Full review text | | `text.language` | Review language when provided | | `review_photos` | Photos attached to the review | | `author.displayName` | Reviewer display name | | `author.encid` | Raw Yelp reviewer ID | | `author.profilePhoto.photoUrl.userSrc` | Reviewer profile image | | `author.displayLocation` | Reviewer public location | | `author.reviewCount` | Reviewer review count | | `author.friendCount` | Reviewer friend count | | `author.businessPhotoCount` | Reviewer business photo count | | `author.currentTruncatedEliteYear` | Yelp Elite year when provided | | `bizUserPublicReply.text` | Business owner reply text when available | | `bizUserPublicReply.displayName` | Public name of the reply author | | `bizUserPublicReply.replyCreatedAt` | Business reply date | ### How to scrape Yelp reviews 1. Open **Yelp Reviews Scraper** on Apify. 2. Go to the **Input** tab. 3. Paste one or more Yelp business URLs, for example `https://www.yelp.com/biz/supermoon-bakehouse-new-york`. 4. Choose review sorting, such as `Newest_first` for monitoring recent feedback. 5. Choose a star filter, or keep `All_ratings`. 6. Set the maximum number of reviews per business, or enable **Scrape All Available Reviews**. 7. Click **Start**. 8. Open the **Output** tab and download the dataset or access it through the Apify API. ### Input example Yelp Reviews Scraper has a short input form. The most important field is `reviewsUrl`, which accepts Yelp business URLs or business IDs. ```json { "reviewsUrl": [ "https://www.yelp.com/biz/supermoon-bakehouse-new-york", "https://www.yelp.com/biz/joes-pizza-new-york-7" ], "reviewsSorting": "Newest_first", "ratingReviews": "All_ratings", "numberOfReviews": 100, "scrapeAllReviews": false } ```` #### Input fields | Input field | Description | | ------------------ | ----------------------------------------------------------------------------------------------- | | `reviewsUrl` | Yelp business URLs or 22-character business IDs. | | `reviewsSorting` | Review order: Yelp default, newest first, oldest first, highest rated, lowest rated, or elites. | | `ratingReviews` | Rating filter: all ratings or a single star rating. | | `numberOfReviews` | Maximum reviews to collect per business when scraping all reviews is disabled. | | `scrapeAllReviews` | Collect every available review page for each business. | ### Output example Each dataset item is a raw Yelp review object. The Actor does not add fields such as input URL, scrape timestamp, sorting mode, or rating filter to the review record. ```json { "encid": "8xoqhzQHWtIHJThaZlVY2A", "text": { "full": "Great service and excellent pizza. The sauce was bright, the crust was crisp, and delivery arrived hot.", "language": "en", "__typename": "ReviewText" }, "reviewCreatedAt": "2026-04-23T18:16:09-04:00", "rating": 5, "author": { "encid": "5RfBqwE_rQrPIDDFCOhA1Q", "displayName": "Sharon W.", "displayLocation": "Brooklyn, NY", "currentTruncatedEliteYear": "26", "reviewCount": 336, "friendCount": 62, "businessPhotoCount": 789, "profilePhoto": { "photoUrl": { "userSrc": "https://s3-media0.fl.yelpcdn.com/photo/example/60s.jpg" } } }, "review_photos": ["https://s3-media0.fl.yelpcdn.com/bphoto/example/o.jpg"], "bizUserPublicReply": { "text": "", "displayName": "", "role": "", "profilePhoto": "", "replyCreatedAt": "" } } ``` You can download the dataset extracted by Yelp Reviews Scraper in various formats such as JSON, HTML, CSV, or Excel. ### How much does it cost to scrape Yelp reviews? The cost of scraping Yelp reviews depends on the number of businesses, the number of reviews requested per business, pagination depth, and API response speed. Small jobs with a few Yelp pages and limited review counts should be lightweight. Larger runs that scrape all available reviews across many businesses will use more compute and more upstream API requests. This Actor uses the `RAPID_API_KEY` environment variable to call the Yelp Business API on RapidAPI, so you should also account for your RapidAPI plan. On Apify, you can start with the free tier for testing and then scale with paid plans when you need higher throughput, scheduled monitoring, or larger datasets. ### Tips for better Yelp review scraping - Use `Newest_first` for daily or weekly review monitoring. - Use `1_star` or `2_stars` to find negative feedback and support issues. - Use `5_stars` to collect positive reviews for testimonial analysis. - Keep `numberOfReviews` close to your real need to reduce runtime. - Use multiple smaller runs when monitoring many businesses on different schedules. - Check the **All fields** dataset view when you need raw nested data not shown in the default table. ### Yelp Reviews Scraper vs Yelp Ultimate Scraper Use this Actor when you only need review data from known Yelp businesses. Use [Yelp Ultimate Scraper](https://apify.com/api-ninja/yelp-ultimate-scraper) when you need a broader Yelp workflow. | Actor | Best for | Data types | | -------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------- | | Yelp Reviews Scraper | Focused review extraction from known business URLs or IDs | Reviews only | | [Yelp Ultimate Scraper](https://apify.com/api-ninja/yelp-ultimate-scraper) | Search, business details, reviews, menus, and dishes | Listings, profiles, reviews, menus, popular dishes | ### FAQ, legality, and support #### Is it legal to scrape Yelp reviews? This Actor is intended for responsible collection of publicly available review data. Your results may contain personal data such as reviewer display names, public locations, profile photos, or review text. Personal data is protected by GDPR in the European Union and by other privacy regulations around the world. Do not scrape or process personal data unless you have a legitimate reason to do so. If you are unsure, consult a legal professional. #### Does this Actor use the official Yelp API? This Actor calls a Yelp Business API available through RapidAPI. It is designed as a practical review extraction workflow on Apify with dataset storage, retries, scheduling, and exports. #### Why did a Yelp business return no reviews? The business URL or ID may be invalid, the upstream API may not return reviews for that profile, or the selected rating filter may exclude all available reviews. Try Yelp default sorting with `All_ratings` first to confirm that reviews are available. #### Can I scrape Yelp business details too? This Actor intentionally extracts reviews only. For business search, profile details, menus, and popular dishes, use [Yelp Ultimate Scraper](https://apify.com/api-ninja/yelp-ultimate-scraper). #### Where can I get help? Open the Actor's **Issues** tab on Apify and include your run ID, input, and a short description of the problem. Custom Yelp scraping workflows and additional output transformations can also be built on top of this Actor. # Actor input Schema ## `reviewsUrl` (type: `array`): Provide Yelp business URLs or 22-character business IDs to scrape reviews. Example: https://www.yelp.com/biz/supermoon-bakehouse-new-york ## `reviewsSorting` (type: `string`): Choose how reviews should be ordered in the output. ## `ratingReviews` (type: `string`): Filter reviews by star rating. ## `numberOfReviews` (type: `integer`): Maximum number of reviews to collect per business profile. Ignored when Scrape All Available Reviews is enabled. ## `scrapeAllReviews` (type: `boolean`): Ignore the max reviews limit and collect every review page available for each business. ## Actor input object example ```json { "reviewsUrl": [ "https://www.yelp.com/biz/supermoon-bakehouse-new-york" ], "reviewsSorting": "Yelp_sort", "ratingReviews": "All_ratings", "numberOfReviews": 100, "scrapeAllReviews": false } ``` # Actor output Schema ## `reviews` (type: `string`): No description ## `raw` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "reviewsUrl": [ "https://www.yelp.com/biz/supermoon-bakehouse-new-york" ] }; // Run the Actor and wait for it to finish const run = await client.actor("api-ninja/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "reviewsUrl": ["https://www.yelp.com/biz/supermoon-bakehouse-new-york"] } # Run the Actor and wait for it to finish run = client.actor("api-ninja/yelp-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "reviewsUrl": [ "https://www.yelp.com/biz/supermoon-bakehouse-new-york" ] }' | apify call api-ninja/yelp-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=api-ninja/yelp-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yelp Reviews Scraper", "description": "๐ŸŽ Scrape Yelp customer reviews from business URLs or IDs with sorting, rating filters, pagination, and resilient API retries.", "version": "0.0", "x-build-id": "taLsgpAYBNmAKO8jr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-ninja~yelp-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-ninja-yelp-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/api-ninja~yelp-reviews-scraper/runs": { "post": { "operationId": "runs-sync-api-ninja-yelp-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/api-ninja~yelp-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-api-ninja-yelp-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "reviewsUrl" ], "properties": { "reviewsUrl": { "title": "๐Ÿ”— Business URLs or IDs", "type": "array", "description": "Provide Yelp business URLs or 22-character business IDs to scrape reviews. Example: https://www.yelp.com/biz/supermoon-bakehouse-new-york", "items": { "type": "string" } }, "reviewsSorting": { "title": "โ†•๏ธ Review Sorting", "enum": [ "Yelp_sort", "Newest_first", "Oldest_first", "Highest_rated", "Lowest_rated", "Elites" ], "type": "string", "description": "Choose how reviews should be ordered in the output.", "default": "Yelp_sort" }, "ratingReviews": { "title": "โญ Star Rating Filter", "enum": [ "All_ratings", "5_stars", "4_stars", "3_stars", "2_stars", "1_star" ], "type": "string", "description": "Filter reviews by star rating.", "default": "All_ratings" }, "numberOfReviews": { "title": "๐Ÿ“Š Max Reviews per Business", "minimum": 45, "type": "integer", "description": "Maximum number of reviews to collect per business profile. Ignored when Scrape All Available Reviews is enabled.", "default": 100 }, "scrapeAllReviews": { "title": "Scrape All Available Reviews", "type": "boolean", "description": "Ignore the max reviews limit and collect every review page available for each business.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```