# Yelp Scraper - Local Business Data, Hours & Contacts (`webdatalabs/yelp-business-scraper-pro`) Actor Scrape Yelp local businesses by city and category: name, address, phone, website, opening hours, categories, price tier, rating and review count. No login. Export CSV/JSON. - **URL**: https://apify.com/webdatalabs/yelp-business-scraper-pro.md - **Developed by:** [WebDataLabs](https://apify.com/webdatalabs) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 business scrapeds 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Scraper — Local Business Data, Hours & Contacts Turn any US city into a clean spreadsheet of local businesses: **name, street address, phone, website, opening hours, categories, price tier, rating and review count** — one flat row each, ready for CSV, Excel, Google Sheets or your CRM. ### What you get | Field | Example | |---|---| | `name` | Moonshine Grill | | `address`, `city`, `state`, `postalCode` | 900 E 11th St · Austin · TX · 78702 | | `phone` | (512) 653-1187 | | `website` | https://franklinbbq.com/ | | `categories` | Southern, Breakfast & Brunch, Cocktail Bars | | `priceRange` | `$$` | | `rating` / `reviewCount` | 4.4 / 6400 | | `hours` | Mon: Closed · Tue: 11:00 AM - 3:00 PM · … | | `photoUrls` | Yelp CDN links | | `yelpUrl`, `businessId`, `alias`, `ranking` | stable identifiers + search position | **`website` is the field most people actually come for** — Yelp's own official API does not return it at any price tier. ### Why this one - **Real review counts.** Yelp's UI abbreviates to "6.4k". Other scrapers ship `6.4`. This returns `6400`. - **Honest completeness.** Every row carries `enrichmentStatus` — `full`, `search_only` or `blocked` — so you always know whether a null means "Yelp doesn't list it" or "we couldn't read it". Nothing is ever invented to fill a gap: no `"N/A"`, no `0` ratings, no placeholder addresses. - **Honest coverage.** Yelp will not paginate an anonymous search past roughly **60 results**, no matter what total it displays. Most scrapers quietly hand you a truncated list that looks complete; this one tells you in the run summary exactly which queries were cut short and what to do about it. - **No fake success.** A run that gets refused on every query fails loudly rather than finishing green with an empty dataset. ### Input | Field | Required | Default | Notes | |---|---|---|---| | `location` | yes* | — | `"Austin, TX"` or a ZIP code | | `searchTerms` | no | `["Restaurants"]` | one query per term | | `maxResults` | no | `100` | stop after N businesses | | `enrichDetails` | no | `true` | off = faster/cheaper, search-page fields only | | `startUrls` | no | `[]` | paste Yelp business URLs instead of searching | \* either `location` or `startUrls`. ```json { "location": "Austin, TX", "searchTerms": ["Pizza", "Coffee", "Sushi"], "maxResults": 200, "enrichDetails": true } ```` #### Covering a whole city — read this first **Yelp serves roughly 60 results per search query, then stops paginating.** It will happily *tell* you there are 240 matches, but it does not hand them over to anonymous visitors — offsets beyond the first few pages are refused outright. That is Yelp's limit, not the scraper's, and no scraper can honestly promise you 240 from one query. So: **use more queries, not a bigger `maxResults`.** Each search term gets its own ~60-result allowance. ```json { "location": "Los Angeles, CA", "searchTerms": ["Pizza", "Sushi", "Tacos", "Thai", "Burgers", "Ramen", "Steakhouse", "Vegan"], "maxResults": 400 } ``` Eight specific terms will get you far more of a city than one broad `"Restaurants"` ever will. Searching per ZIP code works the same way. The run summary names every query that was cut short and how many it returned versus how many Yelp claimed. ### Example output ```json { "businessId": "cs6HfZNykLVitm09jWFqWg", "alias": "moonshine-grill-austin", "name": "Moonshine Grill", "yelpUrl": "https://www.yelp.com/biz/moonshine-grill-austin", "ranking": 1, "address": "303 Red River St", "city": "Austin", "state": "TX", "postalCode": "78701", "country": "US", "phone": "(512) 236-9599", "website": "https://moonshinegrill.com/", "categories": ["Southern", "Breakfast & Brunch", "Cocktail Bars"], "priceRange": "$$", "rating": 4.4, "reviewCount": 6400, "isPermanentlyClosed": null, "hours": [ { "day": "Mon", "hours": "11:00 AM - 10:00 PM" }, { "day": "Tue", "hours": "11:00 AM - 10:00 PM" } ], "photoUrls": ["https://s3-media0.fl.yelpcdn.com/bphoto/…/l.jpg"], "enrichmentStatus": "full", "searchTerm": "Restaurants", "searchLocation": "Austin, TX", "scrapedAt": "2026-07-27T12:00:00.000Z" } ``` Three dataset views ship with the actor: **Overview**, **Contact list** (name/phone/website/address — the lead-gen export), and **Full data**. ### Pricing Pay per result. You are charged **$0.004 per business** delivered, plus Apify's platform usage. Nothing else — a run that returns 40 businesses costs about **$0.16**. Turning `enrichDetails` off makes runs substantially faster and cheaper, at the cost of the address, phone, website and hours fields. ### Run summary Every run writes an `OUTPUT` record to the key-value store with per-query coverage, how many rows were `full` vs `search_only` vs `blocked`, request counts, and any 240-cap warning. Use it to check a run really did cover what you asked for. ### What this actor does not collect - **No reviews, no reviewer names, photos or profiles.** Only the aggregate `rating` and `reviewCount` numbers. This keeps the output free of personal data. - **No images are copied.** Photos are referenced by URL only. - **No login, no accounts.** Only publicly visible pages are read, at a deliberately measured request rate. ### Notes - US residential proxy is required and enabled by default. Yelp filters by IP reputation, so datacenter proxies will be refused. - Sponsored/ad placements are excluded — you get organic listings only. - You are responsible for how you use the data you collect, including compliance with applicable law and with Yelp's terms. *** Built by [WebDataLabs](https://apify.com/webdatalabs). Found a problem or need another field? Open an issue on the actor page. # Actor input Schema ## `location` (type: `string`): City, state or ZIP code to search in. Example: "Austin, TX" or "78702". ## `searchTerms` (type: `array`): What to search for. Each term runs as its own query. Yelp stops paginating a single query at roughly 60 results, so use several specific terms ("Pizza", "Sushi", "Coffee") rather than one broad one to cover a city. ## `maxResults` (type: `integer`): Stop after this many businesses across all search terms. Note that Yelp serves only ~60 per search term, so raising this alone will not return more - add more search terms. ## `enrichDetails` (type: `boolean`): Visit each business page to add address, phone, website and opening hours. Turn off for a faster, cheaper run that returns only what the search page shows (name, rating, review count, price tier, categories). ## `startUrls` (type: `array`): Optional. Paste specific Yelp business URLs to scrape them directly instead of searching. ## `proxyConfiguration` (type: `object`): US residential proxy is required. Yelp limits by IP reputation and will refuse datacenter traffic. ## `minDelayMs` (type: `integer`): Minimum pause between requests. Lower values are faster but get refused more often, which costs more proxy traffic than it saves in time. ## `maxRetries` (type: `integer`): How many times to retry a refused request on a fresh IP. ## `debug` (type: `boolean`): Log every request outcome. Use when reporting a problem. ## Actor input object example ```json { "location": "Austin, TX", "searchTerms": [ "Pizza", "Coffee", "Dentists" ], "maxResults": 100, "enrichDetails": true, "startUrls": [ "https://www.yelp.com/biz/franklin-barbecue-austin" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "minDelayMs": 2500, "maxRetries": 6, "debug": false } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `contact` (type: `string`): No description ## `full` (type: `string`): No description ## `runSummary` (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 = { "location": "Austin, TX", "searchTerms": [ "Restaurants" ] }; // Run the Actor and wait for it to finish const run = await client.actor("webdatalabs/yelp-business-scraper-pro").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 = { "location": "Austin, TX", "searchTerms": ["Restaurants"], } # Run the Actor and wait for it to finish run = client.actor("webdatalabs/yelp-business-scraper-pro").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 '{ "location": "Austin, TX", "searchTerms": [ "Restaurants" ] }' | apify call webdatalabs/yelp-business-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=webdatalabs/yelp-business-scraper-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yelp Scraper - Local Business Data, Hours & Contacts", "description": "Scrape Yelp local businesses by city and category: name, address, phone, website, opening hours, categories, price tier, rating and review count. No login. Export CSV/JSON.", "version": "1.0", "x-build-id": "pelQZHGPVPvDlzhbY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatalabs~yelp-business-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatalabs-yelp-business-scraper-pro", "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/webdatalabs~yelp-business-scraper-pro/runs": { "post": { "operationId": "runs-sync-webdatalabs-yelp-business-scraper-pro", "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/webdatalabs~yelp-business-scraper-pro/run-sync": { "post": { "operationId": "run-sync-webdatalabs-yelp-business-scraper-pro", "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", "properties": { "location": { "title": "Location", "type": "string", "description": "City, state or ZIP code to search in. Example: \"Austin, TX\" or \"78702\"." }, "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search for. Each term runs as its own query. Yelp stops paginating a single query at roughly 60 results, so use several specific terms (\"Pizza\", \"Sushi\", \"Coffee\") rather than one broad one to cover a city.", "default": [ "Restaurants" ], "items": { "type": "string" } }, "maxResults": { "title": "Maximum businesses", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many businesses across all search terms. Note that Yelp serves only ~60 per search term, so raising this alone will not return more - add more search terms.", "default": 100 }, "enrichDetails": { "title": "Fetch full business details", "type": "boolean", "description": "Visit each business page to add address, phone, website and opening hours. Turn off for a faster, cheaper run that returns only what the search page shows (name, rating, review count, price tier, categories).", "default": true }, "startUrls": { "title": "Yelp business URLs", "type": "array", "description": "Optional. Paste specific Yelp business URLs to scrape them directly instead of searching.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "US residential proxy is required. Yelp limits by IP reputation and will refuse datacenter traffic.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "minDelayMs": { "title": "Delay between requests", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Minimum pause between requests. Lower values are faster but get refused more often, which costs more proxy traffic than it saves in time.", "default": 2500 }, "maxRetries": { "title": "Maximum retries", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many times to retry a refused request on a fresh IP.", "default": 6 }, "debug": { "title": "Verbose logging", "type": "boolean", "description": "Log every request outcome. Use when reporting a problem.", "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 } } } } } } } } } } ```