# Yelp Reviews via Fusion API (`renzomacar/yelp-reviews`) Actor Extract 3 most-recent Yelp reviews per business via official Fusion API. BYOK pattern. 100% reliable. - **URL**: https://apify.com/renzomacar/yelp-reviews.md - **Developed by:** [Renzo Madueno](https://apify.com/renzomacar) (community) - **Categories:** Business, Marketing, Lead generation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Yelp Reviews via Fusion API Extract the 3 most-recent reviews per Yelp business via the official Yelp Fusion API. **Bring your own free API key** (5,000 calls/day at [docs.developer.yelp.com](https://docs.developer.yelp.com/)). ### Why this actor Yelp Fusion API limits review extraction to **3 most-recent reviews per business** (technical limitation of the official API). For full review extraction at scale, you'd need to scrape Yelp directly — but Yelp uses PerimeterX which makes that impractical for most users. This actor gives you reliable access to the 3 most recent reviews — perfect for monitoring fresh sentiment on businesses, getting recent customer voice for marketing, or building agentic workflows that surface "what are people saying RIGHT NOW". ### Output | Field | Description | |-------|-------------| | `businessId` | Yelp business ID or alias (your input) | | `reviewId` | Yelp review ID | | `rating` | 1-5 star rating | | `text` | Review text (truncated by Yelp to ~160 chars in Fusion API) | | `timeCreated` | When the review was posted | | `url` | Direct URL to the review | | `userName`, `userImageUrl`, `userProfileUrl` | Reviewer info | | `scrapedAt` | ISO timestamp | ### Pricing - **$0.001 per review** ($1.00 per 1,000 reviews) - Most businesses return 3 reviews → 3 reviews × $0.001 = $0.003 per business - 1,000 businesses cost approximately $3.00 ### Found this useful? Please leave a quick review on the **Reviews** tab above — it helps small developers compete on the Apify Store. ### Related scrapers - [Yelp Business Search via Fusion API](https://apify.com/renzomacar/yelp-fusion-search) — Find businesses by category/location, then feed IDs into this scraper. - [Trustpilot Reviews Scraper](https://apify.com/renzomacar/trustpilot-reviews) — Customer reviews on Trustpilot. - [Google Maps Reviews Scraper](https://apify.com/renzomacar/google-maps-reviews) — Google Maps reviews for the same businesses. # Actor input Schema ## `yelpApiKey` (type: `string`): Free key at https://docs.developer.yelp.com/ (5,000 calls/day). ## `businessIds` (type: `array`): List of Yelp business IDs (e.g., 'WavvLdfdP6g8aZTtbBQHTw') or aliases (e.g., 'joes-pizza-new-york'). ## `locale` (type: `string`): Filter reviews by locale (e.g., en_US, es_MX). Leave empty for all. ## Actor input object example ```json { "businessIds": [ "l-industrie-pizzeria-brooklyn", "joes-pizza-new-york" ], "locale": "" } ```` # 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 = { "businessIds": [ "l-industrie-pizzeria-brooklyn", "joes-pizza-new-york" ] }; // Run the Actor and wait for it to finish const run = await client.actor("renzomacar/yelp-reviews").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 = { "businessIds": [ "l-industrie-pizzeria-brooklyn", "joes-pizza-new-york", ] } # Run the Actor and wait for it to finish run = client.actor("renzomacar/yelp-reviews").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 '{ "businessIds": [ "l-industrie-pizzeria-brooklyn", "joes-pizza-new-york" ] }' | apify call renzomacar/yelp-reviews --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=renzomacar/yelp-reviews", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yelp Reviews via Fusion API", "description": "Extract 3 most-recent Yelp reviews per business via official Fusion API. BYOK pattern. 100% reliable.", "version": "0.1", "x-build-id": "a03XBwkKp0ZmINARs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/renzomacar~yelp-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-renzomacar-yelp-reviews", "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/renzomacar~yelp-reviews/runs": { "post": { "operationId": "runs-sync-renzomacar-yelp-reviews", "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/renzomacar~yelp-reviews/run-sync": { "post": { "operationId": "run-sync-renzomacar-yelp-reviews", "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": [ "yelpApiKey", "businessIds" ], "properties": { "yelpApiKey": { "title": "Yelp Fusion API Key", "type": "string", "description": "Free key at https://docs.developer.yelp.com/ (5,000 calls/day)." }, "businessIds": { "title": "Yelp Business IDs or Aliases", "type": "array", "description": "List of Yelp business IDs (e.g., 'WavvLdfdP6g8aZTtbBQHTw') or aliases (e.g., 'joes-pizza-new-york').", "items": { "type": "string" } }, "locale": { "title": "Locale", "type": "string", "description": "Filter reviews by locale (e.g., en_US, es_MX). Leave empty for all.", "default": "" } } }, "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 } } } } } } } } } } ```