Yelp Business & Reviews Scraper

Export Yelp business names, ratings, review counts, addresses, phone numbers, websites and full review text. Search by query and location, or provide specific business URLs. Each dataset row represents one business, with its reviews nested inside that row.

Use the output to compare local competitors, track customer feedback, or build a business research list. Optional sentiment labels and lead scores use transparent rules.

Quick start

1. Enter a search query and location, such as coffee and San Francisco, CA.
2. Set the number of businesses and reviews you need. Start with three businesses and three reviews each.
3. Run the Actor. Open Overview for business details or Reviews for individual review rows.
4. Export JSON for complete review text, or CSV/Excel for a business table.

{
  "mode": "search",
  "searchQuery": "coffee",
  "location": "San Francisco, CA",
  "maxBusinesses": 3,
  "maxReviewsPerBusiness": 3,
  "includeSentiment": true,
  "includeLeadScore": true
}

For a specific business:

{
  "mode": "direct_urls",
  "businessUrls": [
    "https://www.yelp.com/biz/golden-boy-pizza-san-francisco"
  ],
  "maxBusinesses": 1,
  "maxReviewsPerBusiness": 25
}

Inputs

Field	Purpose
mode	search or direct_urls
searchQuery, location	Search terms and city, state or postal code
businessUrls	Public yelp.com/biz/ URLs or business aliases
maxBusinesses	Maximum distinct businesses to inspect, 1–500; default 50
maxReviewsPerBusiness	Maximum unique reviews per business, 0–100; default 20
minRating, maxRating	Optional business-rating filters from 1 to 5
includeSentiment	Add a rule-based sentiment label to each review
includeLeadScore	Add a score from business rating, review count and sampled sentiment
proxyConfiguration	Optional proxy override; Apify Unblocker is the default

Yelp limits the search results it makes available. The Actor stops when those results are exhausted or the business/charge limit is reached. Rating filters can reduce the saved row count; they do not trigger an unlimited search for replacements. Reviews follow Yelp's recommended order, which can differ from newest-first order. No Yelp account or separate service key is required.

Existing saved inputs that explicitly select residential proxies keep that override. Remove the override or select UNBLOCKER to use the repaired access path. A blocked source fails visibly instead of producing a successful empty report.

Output

Business fields from Golden Boy Pizza, checked September 5, 2026:

{
  "business_id": "PTFxtXS47ZVRCdZIrEWvGw",
  "business_name": "Golden Boy Pizza",
  "url": "https://www.yelp.com/biz/golden-boy-pizza-san-francisco",
  "rating": 4.3,
  "review_count": 4868,
  "category": "Pizza, Italian",
  "address": "542 Green St, San Francisco, CA 94133",
  "phone": "(415) 982-9738",
  "website": "http://www.goldenboypizza.com",
  "price_range": "$"
}

The complete row also includes hours, scraped_at, reviews, reviews_count, and optional lead_score. Every review contains review_id, rating, full text, date, reviewer_name, reviewer_location, and optional sentiment. Missing source values remain null.

review_count is Yelp's total for the business. reviews_count is the number actually extracted in this run. Counts can change while Yelp updates its pages. Business IDs and review IDs are deduplicated within a run; scheduled runs can intentionally return the same business again.

Pricing

The Free-plan result price is $0.025 per business, or $25 per 1,000 businesses, plus the Actor Start event. Reviews, contact fields, sentiment and lead scores are included in the business row price.

Apify plan	Price per business
Free	$0.025
Bronze	$0.0225
Silver	$0.02125
Gold	$0.020
Platinum	$0.01875
Diamond	$0.0175

At the 512 MB default, one start event applies: $0.00005 on Free or $0.000045 on Bronze. Three businesses therefore cost $0.07505 on Free or $0.067545 on Bronze in Actor event fees, whether you request zero or 25 reviews each. Higher run memory changes the start-event count: one event per GB, with a minimum of one.

Set a maximum total charge in Run options. The Actor checks the affordable business count before fetching output and uses that count to cap source work too. Failed or filtered businesses do not generate a result event. A failure after earlier businesses were saved can leave a partial, billable dataset; inspect the log before rerunning.

Sentiment and lead scores

Sentiment combines the star rating with positive and negative keyword counts. It is a rough label and can miss sarcasm, mixed opinions or languages outside its English keyword list.

The lead score assigns up to 40 points for rating, up to 30 for total review count, and up to 30 for the positive share of extracted review sentiments. Disabling sentiment removes that last contribution. This score is a research aid, not a prediction of purchase intent.

FAQ

Can I schedule repeat exports? Yes. Save an Apify Task and schedule it. Use business_id as the key when updating your own database or spreadsheet.

Why are fewer results returned? Yelp may expose fewer businesses or reviews than requested. Rating filters and the maximum charge also reduce output. Unreadable pages and invalid review feeds raise an error.

Where do I read the reviews? Select the Reviews dataset view to see one displayed row per review, including its full text and rating. The Overview view shows business contact and rating fields. The expanded view does not create extra stored rows or result charges. Download JSON for the original business rows with nested reviews.

Does this support every Yelp country domain? The supported URL input is yelp.com. Search uses the supplied location without substituting another city.

How can I get help? Open an issue on this Actor and include the run URL. Enable shared debugging if the developer needs access to its input, log or output. Avoid posting credentials in issues.