# Yelp Scraper & API - Business Leads, Reviews, Whole-City Search (`headply/yelp-scraper`) Actor Yelp API alternative: scrape every Yelp business in a city or category with phone, website, address, rating, hours and categories, plus reviews. Build Yelp lead lists or a Yelp dataset. Export to JSON, CSV or Excel. - **URL**: https://apify.com/headply/yelp-scraper.md - **Developed by:** [Mayowa Ogedengbe](https://apify.com/headply) (community) - **Categories:** Lead generation, Business, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 businesses 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Yelp Scraper Scrape **Yelp businesses** by search term and location and get far more than the 240 results Yelp shows per search. Each business comes with **phone, website, full address, coordinates, hours, price range, categories, rating, review count and claim status**. Optionally, get **every review**, with full text, date, reactions, photos and the **owner's reply**. No login, no Yelp API key. It is built for local lead generation, reputation management and market research. The official Yelp API now costs $7.99 to $14.99 per 1,000 calls, with 300 to 500 calls a day, and returns at most three reviews per business. #### Sample output (real run: plumbers in Austin, TX) | Business | Rating | Reviews | Phone | Website | City | |---|---|---|---|---|---| | Blue Dragon Plumbing | 4.9 | 532 | (512) 947-2491 | bluedragonplumbing.com | Austin | | Rooterman Plumbing | 4.7 | 516 | (512) 900-7676 | rootermanofaustin.com | Austin | | Proven Plumbing & Air | 4.9 | 417 | (512) 775-1234 | callproven.com | Cedar Park | | A\&T Service Plumbing | 4.8 | 372 | (512) 825-0983 | atserviceplumbing.com | Austin | Each business also includes address, coordinates, hours, categories, price range, photos and Yelp URL. Reviews come as separate rows with full text, stars, date and owner reply. #### Why this one | | This Actor | Yelp Fusion API | Typical Store alternative | |---|---|---|---| | Reviews per business | **All of them** | 3 excerpts | All, slower | | Businesses per search | Whole city (tiles past the 240 cap) | 240 max | Usually capped | | Only-new-reviews mode | Yes | No | Rarely | | Price | **$3 / 1,000 businesses, $0.30 / 1,000 reviews** | $7.99 to $14.99 / 1,000 calls | $0.30 to $5 / 1,000 reviews, often plus start fees | **What it costs:** a 1,000-business lead list = $3. All 2,000 reviews of a busy restaurant = $0.60. ### What this Actor does - **Searches Yelp** for any term in any city, neighborhood or ZIP code, for example "plumber" in "Austin, TX". - **Gets past the 240-result limit.** Yelp stops showing results after 24 pages. When a search is capped, the Actor searches again from a grid of points across the area, going finer while that keeps finding new businesses, and removes duplicates. One search for restaurants in Austin, TX returned 2,409 businesses; for plumbers, which mostly serve areas rather than sit at an address, about 680. - Returns **full business details** for every result: phone, website, address and postal code, latitude and longitude, neighborhoods, opening hours for the week, price range, categories, rating, review count, claimed status, year established, specialties and Yelp's summary. - **Scrapes reviews**: all of them, or the newest N, with full text, star rating, date, helpful, thanks, love-this and oh-no counts, photos, and the owner's public reply. - **Filters reviews** by star rating (for example only 1 and 2 stars), date, or language. - **Returns only new reviews since your last run.** It remembers the newest review it has seen for each business, so a scheduled run returns, and charges for, new reviews only. - Accepts **Yelp business URLs** directly, for tracking your own locations or a list of competitors. ### What data can you extract from Yelp? | Group | Fields | | --- | --- | | Business | id, name, url, rating, reviewCount, priceRange, categories, summary, isClaimed, isClosed, isOpenNow, yearEstablished, specialties, photo | | Contact | phone, website, messagingEnabled | | Location | address (street, city, region, postalCode, country, formatted), coordinates (lat, lng), neighborhoods, serviceArea | | Hours | hours: each day with its opening hours, and special hours where set | | Search | searchTerm, searchLocation, searchRank | | Review | reviewId, rating, date, text, language, helpfulCount, thanksCount, loveThisCount, ohNoCount, photos, isUpdated, url | | Owner reply | ownerReply.text, ownerReply.date, ownerReply.ownerRole | | Reviewer (opt-in) | name, location, reviewCount, friendCount, photoCount, eliteYear | ### How to scrape Yelp 1. Add **search terms** such as `plumber`, `sushi` or `dentist`, and **locations** such as `Austin, TX` or `94110`. Or paste **Yelp business URLs**. 2. Set **Maximum businesses per search**. Above 240, the Actor splits the map automatically. 3. Turn on **Include reviews** if you want them, and set how many per business. 4. Run it and export to JSON, CSV or Excel, or connect it to your own tools through the API. #### Example: every plumber in Austin, with contact details ```json { "searchTerms": ["plumber"], "locations": ["Austin, TX"], "maxBusinessesPerSearch": 2000 } ``` #### Example: daily monitoring of new negative reviews ```json { "startUrls": [{"url": "https://www.yelp.com/biz/tartine-bakery-san-francisco"}], "includeReviews": true, "maxReviewsPerBusiness": 0, "reviewRatings": ["1", "2"], "onlyNewReviews": true } ``` Schedule it daily. The first run returns the full history; later runs return only what is new. #### Example output (business, trimmed) ```json { "type": "business", "id": "ri7UUYmx21AgSpRsf4-9QA", "name": "Tartine Bakery", "url": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3", "rating": 4.2, "reviewCount": 9204, "priceRange": "$$", "categories": ["Bakeries", "Cafes", "Desserts"], "phone": "(415) 487-2600", "website": "https://tartinebakery.com/san-francisco/bakery", "address": {"street": "600 Guerrero St", "city": "San Francisco", "region": "CA", "postalCode": "94110", "country": "US"}, "coordinates": {"lat": 37.761656, "lng": -122.423995}, "neighborhoods": ["Mission"], "hours": [{"day": "Mon", "hours": ["7:30 AM - 6:00 PM"]}], "isClaimed": true } ``` #### Example output (review, trimmed) ```json { "type": "review", "reviewId": "HW0ZygMXZtlM_u-C3z3FLw", "businessName": "Tartine Bakery", "rating": 5, "date": "2026-09-14T06:40:19-07:00", "text": "Very nicely appointed bakery. Delicious variety of baked goods and very good coffee too...", "helpfulCount": 0, "ownerReply": null } ``` ### How much does it cost to scrape Yelp? You pay per result, with lower prices on higher Apify plans: one price per business and a much smaller price per review. Businesses and reviews you filter out are not charged. The only-new-reviews mode means repeat monitoring costs only what is new. Current prices are on the pricing tab. ### Tips - **Whole cities:** raise *Maximum businesses per search* to what you expect to exist. Large, dense searches take longer: about 15 to 25 minutes for 2,000 restaurants. For the most complete coverage of a big metro, also add its suburbs or ZIP codes as extra locations; duplicates are removed only within one search, so use the business id to merge. - **Coordinates:** businesses that serve customers at their location have coordinates; service-area businesses (plumbers, movers) often have no public address, so their coordinates are empty. - **Faster runs:** search pages are the slow part. Business details and reviews are quick, so review-heavy runs finish fast. - **Reviewer names are off by default.** They identify people. Turn them on only if you have a lawful basis to process them. - **Businesses and reviews share one dataset**, told apart by the `type` field. Use the *Businesses* and *Reviews* views in the Output tab. ### FAQ **How is this different from the Yelp API?** The Yelp API returns at most three review excerpts per business, is limited to 300 to 500 calls a day, and costs $7.99 to $14.99 per 1,000 calls. This Actor returns every review in full, and whole cities of businesses. **Can it get all reviews for a business with thousands?** Yes. Pages are fetched in parallel, so 9,000 reviews take minutes, not hours. **Does it include reviews Yelp "does not recommend"?** No, only the reviews Yelp shows by default. **Is scraping Yelp legal?** The Actor collects publicly visible business information and reviews. Reviewer identities are excluded unless you turn them on. Check that your use complies with the laws that apply to you and with Yelp's terms. ### Related Actors - [Yelp Reviews Scraper](https://apify.com/headply/yelp-reviews-scraper): the same engine focused on reviews for a list of businesses, with only-new-reviews monitoring. ### Use it as an API Run it from your own code and get the results back in one call. Replace `YOUR_TOKEN` with your [Apify API token](https://console.apify.com/settings/integrations). ```bash curl -X POST "https://api.apify.com/v2/acts/headply~yelp-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchTerms": ["plumber"], "locations": ["Austin, TX"], "maxReviewsPerBusiness": 50, "coverWholeArea": true}' ``` ```python from apify_client import ApifyClient client = ApifyClient("YOUR_TOKEN") run_input = {'searchTerms': ['plumber'], 'locations': ['Austin, TX'], 'maxReviewsPerBusiness': 50, 'coverWholeArea': True} run = client.actor("headply/yelp-scraper").call(run_input=run_input) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` It also works from Make, Zapier, n8n, Google Sheets and as a tool for AI agents through the [Apify MCP server](https://mcp.apify.com/?tools=headply/yelp-scraper). ### More data tools from the same developer - [Threads Scraper & API](https://apify.com/headply/threads-scraper): posts, reply trees, profiles and keyword search from Threads - [TikTok & YouTube Transcript API](https://apify.com/headply/tiktok-youtube-transcript-scraper): video to text, even without captions - [Google Trends Scraper & API](https://apify.com/headply/google-trends-scraper): hundreds of keywords on one scale, daily history - [Airbnb & Vrbo Scraper](https://apify.com/headply/airbnb-vrbo-scraper): listings, calendars, occupancy and revenue - [Jumia Scraper & API](https://apify.com/headply/jumia-price-intelligence): prices and sellers across 8 African countries # Changelog This Actor's version history is a separate document: https://apify.com/headply/yelp-scraper/changelog.md # Actor input Schema ## `searchTerms` (type: `array`): Search terms, one per line, as you would type them on Yelp: plumber, sushi, dentist. Each term is searched in every location below. ## `locations` (type: `array`): Cities, neighborhoods or ZIP codes, one per line: Austin, TX, Brooklyn, NY, 94110. ## `maxBusinessesPerSearch` (type: `integer`): Stop each search term + location after this many businesses. Yelp itself shows at most 240 per search; above that, the Actor searches from a grid of points across the area to find more. ## `startUrls` (type: `array`): Yelp business pages, for example https://www.yelp.com/biz/tartine-bakery-san-francisco. Use these to track specific businesses, such as your own locations or competitors. ## `includeReviews` (type: `boolean`): Also return reviews for every business, one row per review. ## `maxReviewsPerBusiness` (type: `integer`): 0 means all reviews. Popular businesses have thousands. ## `reviewsSort` (type: `string`): Which reviews come first. ## `reviewRatings` (type: `array`): For example 1 and 2 to collect only negative reviews. Leave empty for all. ## `reviewsNewerThan` (type: `string`): Skip reviews on or before this date. ## `onlyNewReviews` (type: `boolean`): Remembers the newest review seen for each business and returns only newer ones next time. Ideal for scheduled monitoring: you pay only for new reviews. ## `reviewLanguage` (type: `string`): Language code such as en, fr or es. Leave empty for Yelp's default for the business. ## `includeReviewerDetails` (type: `boolean`): Reviewer display name, location, review count and Elite status. Off by default: these identify people, so only turn this on if you have a lawful reason to process them. ## `coverWholeArea` (type: `boolean`): When a search has more than 240 results, search again from a grid of points across the area to find more businesses. Turn off to get only Yelp's first 240. ## `maxConcurrency` (type: `integer`): Businesses and review pages fetched at once. ## `searchConcurrency` (type: `integer`): Search result pages loaded at once. Search pages are slow to load, so more parallel pages finish large areas faster. ## Actor input object example ```json { "searchTerms": [ "plumber" ], "locations": [ "Austin, TX" ], "maxBusinessesPerSearch": 20, "includeReviews": false, "maxReviewsPerBusiness": 50, "reviewsSort": "newest", "onlyNewReviews": false, "includeReviewerDetails": false, "coverWholeArea": true, "maxConcurrency": 10, "searchConcurrency": 48 } ``` # Actor output Schema ## `results` (type: `string`): One item per business and, when reviews are on, one per review. # 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 = { "searchTerms": [ "plumber" ], "locations": [ "Austin, TX" ], "maxBusinessesPerSearch": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("headply/yelp-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 = { "searchTerms": ["plumber"], "locations": ["Austin, TX"], "maxBusinessesPerSearch": 20, } # Run the Actor and wait for it to finish run = client.actor("headply/yelp-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "plumber" ], "locations": [ "Austin, TX" ], "maxBusinessesPerSearch": 20 }' | apify call headply/yelp-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,headply/yelp-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/aBo5ZInwYPgEeRN2k/builds/MwiNaMA2PG9djBvnD/openapi.json