Yelp Business Scraper

Collect businesses from Yelp search results — name, star rating, review count, price range, and a review snippet — by search term and location. No account or login required.

Why use this actor

• No login needed — works on public Yelp search results.
• Search by term + location — e.g. "restaurants in San Francisco", "plumbers in Austin".
• Key business signals — name, rating, number of reviews, price range, and a sample review.
• Bulk collection — pages through all results for each search.
• Stable JSON output — ready for lead lists, market research, or dashboards.
• Handles the site's protection automatically — you don't manage browsers, sessions, or retries.

How it works

1. Enter one or more search terms and locations (or paste Yelp search URLs).
2. The actor unlocks Yelp once, then pages through every result for each term + location.
3. Each business becomes one row — downloadable as JSON, CSV, or Excel.

A US residential proxy is required and set by default. The first unlock may take a few tries on fresh addresses — this is automatic.

Use cases

• Local lead generation — build lists of businesses by category and city.
• Market & competitor research — compare ratings, review volume, and price tiers in an area.
• Review monitoring — track ratings for a category over time.

Input

{
  "searchTerms": ["restaurants"],
  "locations": ["San Francisco, CA"],
  "startUrls": [],
  "maxItemsPerSearch": 0,
  "maxItems": 100,
  "harvestAttempts": 8,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }
}

Field	Type	Description
searchTerms	array	What to search for (combined with each location).
locations	array	Cities/areas, e.g. "San Francisco, CA".
startUrls	array	Optional: paste Yelp search URLs directly (overrides terms/locations).
maxItemsPerSearch	integer	Cap per term+location. 0 = all.
maxItems	integer	Overall cap. 0 = no limit. Default 100.
maxPagesPerSearch	integer	Yelp shows 10/page (~24 page cap).
harvestAttempts	integer	How many fresh IPs to try for the initial unlock. Higher = more reliable. Default 8.
proxyConfiguration	object	US residential required (the default).

Output

One record per business:

{
  "_input": "https://www.yelp.com/search?find_desc=coffee&find_loc=Austin%2C+TX",
  "_scrapedAt": "2026-06-16T14:37:00Z",
  "recordType": "BUSINESS",
  "slug": "andersons-coffee-company-austin",
  "url": "https://www.yelp.com/biz/andersons-coffee-company-austin",
  "name": "Anderson's Coffee Company",
  "rating": 4.6,
  "reviewCount": 197,
  "priceRange": "$$",
  "reviewSnippet": "Amazing coffee. Exceptional service ...",
  "cardText": "..."
}

Field	Type	Description
slug / url	string	Yelp business handle and page link.
name	string	Business name.
rating	number	Star rating (e.g. 4.6).
reviewCount	number	Number of reviews (parsed, e.g. 1.1k → 1100).
priceRange	string	$–$$$$ when shown.
reviewSnippet	string	A sample review excerpt.
cardText	string	Raw result-card text (for any extra fields you want).

Searches that fail to unlock return an _error record, so nothing fails silently.

Notes

• Use a US residential proxy. The initial unlock retries on fresh addresses automatically (harvestAttempts).
• Yelp shows ~10 results per page and caps deep pagination; use tighter searches to go deeper.