Yelp Scraper - Business Reviews & Ratings

Scrapes business information and reviews from Yelp. Accepts either a direct business URL or a search query. Outputs structured business data (name, address, rating, review count, coordinates) and individual reviews with ratings, dates, and reaction counts.

Input

Field	Type	Required	Default	Description
businessUrl	string	Yes*		Direct Yelp business page URL
query	string	No		Search query (used if businessUrl is empty)
location	string	No	""	Location for search (e.g. "San Francisco, CA")
maxReviews	integer	No	20	Maximum reviews to collect (1-5000)

*Either businessUrl or query must be provided.

Output

The dataset contains two record types distinguished by the type field.

Business record (type: "business")

Field	Description
name	Business name
alias	Yelp business alias (last part of the business URL)
address	Street address (city/area only for service-area businesses)
rating	Average star rating
reviewCount	Total number of reviews
url	Yelp business page URL
latitude	Geographic latitude
longitude	Geographic longitude
phone, category, hours, priceRange	Currently always null (see Limitations)

Example:

{
  "type": "business",
  "name": "Made In New York Pizza",
  "address": "421 Amsterdam Ave, New York, NY 10024",
  "phone": null,
  "category": null,
  "rating": 4.2,
  "reviewCount": 655,
  "hours": null,
  "priceRange": null,
  "url": "https://www.yelp.com/biz/made-in-new-york-pizza-new-york",
  "latitude": 40.783841,
  "longitude": -73.977569,
  "alias": "made-in-new-york-pizza-new-york",
  "scrapedAt": "2026-10-21T20:37:30+00:00"
}

Review record (type: "review")

Field	Description
reviewId	Yelp review identifier
businessName	Name of the reviewed business
text	Review text
rating	Star rating (1-5)
date	Review date (YYYY-MM-DD, business local time)
language	Review language (English reviews are collected)
authorPseudonymized	Author name in "FirstName L." format
useful	Useful reaction count
funny	Funny reaction count
cool	Cool reaction count
photosCount	Number of photos attached
url	Review permalink (?hrid=<reviewId>)

How it works

The Actor collects public data from these sources:

1. Search mode: a public web search (Yahoo, then DuckDuckGo) restricted to site:yelp.com/biz returns candidate businesses; the first candidate whose address matches the requested location is kept.
2. The business "Directions" page (/map/<alias>) gives the business id, name, address and coordinates.
3. Rating, review count and reviews come from the JSON endpoint used by Yelp's own business pages, paginated with a cursor. Reviews are de-duplicated by reviewId.

Requests go through Apify Proxy (datacenter first, residential if needed). If a request is blocked, the Actor retries with a new proxy session. It never solves captchas.

Pricing

Pay-per-event, no start fee: $3.50 per 1,000 businesses and $0.21 per 1,000 reviews on the Apify Free plan, with lower prices on paid plans.

Event	Free	Starter	Scale	Business	Enterprise
Business (BUSINESS)	$3.50	$3.00	$2.60	$2.10	$2.10
Review (REVIEW)	$0.21	$0.18	$0.16	$0.13	$0.13

Prices in USD per 1,000 events.

Cost examples (Free plan)

Scenario	Reviews	Cost
Quick look	10	$0.0021
One business in depth	200	$0.042
Many businesses	5,000	$1.05

Limitations

• Phone, category, opening hours and price range are not available from these sources, so they are returned as null.
• Search mode depends on web search engines, which throttle automated traffic; the Actor retries several times and fails with an explicit message if every attempt is blocked. For precise and most reliable targeting, provide businessUrl.
• Search mode scrapes one business: the first search result located in the requested city (or the first result if none matches).
• Only English reviews are collected, in Yelp's default ("Yelp Sort") order.
• Author names are pseudonymized to "FirstName L." format and cannot be recovered.

Related Actors

• Trustpilot Reviews Scraper - Ratings & Company Profile — Scrape Trustpilot reviews for any company domain: rating, title, text, date, company reply and the company profile (TrustScore, review count).
• Google Trends Scraper - Interest Over Time & Related Queries — Scrape Google Trends: interest over time and related queries for up to 5 compared keywords, by country, time range and category.
• App Store Reviews Scraper - iOS & Google Play Reviews — Scrape app reviews and ratings from the Apple App Store and Google Play: review text, rating, date, app version and app metadata.