Yelp Business & Reviews Scraper

Thirdwatch portfolio: 8,800+ users across 140+ public Actors, 2M+ records delivered, >95% run success. Explore all Thirdwatch Actors.

Scrape Yelp business details — name, rating, review counts, price range, categories, full address, phone, website, hours, GPS coordinates — or full review text with mode: "reviews": rating, date, review body, author stats, useful/funny/cool votes, owner replies, and photos.

What you get

Two modes, one Actor:

• business mode (default) — one row per business: ratings, review counts, price range, categories, address, phone, website, hours of operation, and GPS coordinates. Ideal for lead generation, local SEO, and competitive analysis.
• reviews mode — one row per review: star rating, full review text, date, author name/location/friend/review/photo counts, useful/funny/cool votes, the owner's reply, and review photos. Filter by star rating (e.g. only 1-3 star complaints) and choose the sort (newest, lowest rated, ...).

Both modes accept direct Yelp URLs or business aliases, or search queries (e.g., "best pizza new york") that the scraper resolves to Yelp business pages automatically.

Output fields (business mode)

Field	Description
business_name	Business name
rating	Yelp rating (1-5)
reviews_count	Number of reviews
price_range	Price level ($, $$, $$$, $$$$)
categories	Business categories (e.g., "Italian", "Pizza")
address	Street address
city	City
state	US state
postal_code	ZIP code
country	Country code
full_address	Full formatted address
neighborhoods	Yelp neighborhood names
phone	The business's phone number. Left empty when the number Yelp lists does not appear to belong to the business (see Limitations)
yelp_listed_phone	The phone number exactly as Yelp lists it, unchecked
website	Business website URL
hours	Opening hours by day
latitude	GPS latitude
longitude	GPS longitude
image_url	Business photo URL
is_claimed	Whether the business is claimed on Yelp
is_closed	Whether Yelp lists the business as permanently closed
summary	Yelp's one-line description of the business
business_id / alias	Yelp's business ID and URL alias
url	Yelp business page URL

Example output

{
    "business_name": "Joe's Pizza",
    "rating": 4.5,
    "reviews_count": 2300,
    "price_range": "$",
    "categories": ["Pizza", "Italian"],
    "address": "7 Carmine St",
    "city": "New York",
    "state": "NY",
    "phone": "(212) 366-1182",
    "website": "https://joespizzanyc.com",
    "hours": {"Mon": "10:00 AM - 4:00 AM", "Tue": "10:00 AM - 4:00 AM"},
    "latitude": 40.7303,
    "longitude": -74.0023,
    "image_url": "https://s3-media1.fl.yelpcdn.com/bphoto/example.jpg",
    "is_claimed": true,
    "url": "https://www.yelp.com/biz/joes-pizza-new-york"
}

Output fields (reviews mode)

Field	Description
business_alias / business_name / business_url	The business the review belongs to
review_id	Yelp review ID
review_url	Deep link to the review on Yelp
rating	Star rating (1-5)
text	Full review text
date / date_iso	Review date as shown on Yelp, plus an ISO timestamp
language	Review language code
author_name, author_location, author_url	Reviewer profile
author_friend_count, author_review_count, author_photo_count, author_elite_year	Reviewer stats, when Yelp shows them on the review card (null otherwise)
useful_votes, funny_votes, cool_votes	Community votes on the review
owner_reply	{text, date, author} when the business replied, else null
photos	URLs of photos attached to the review

Example review

{
    "business_alias": "franklin-barbecue-austin",
    "business_name": "Franklin Barbecue",
    "business_url": "https://www.yelp.com/biz/franklin-barbecue-austin",
    "review_id": "AbCdEf123",
    "review_url": "https://www.yelp.com/biz/franklin-barbecue-austin?hrid=AbCdEf123",
    "rating": 2,
    "text": "Waited three hours and the brisket was dry...",
    "date": "Aug 14, 2026",
    "author_name": "Jane D.",
    "author_location": "Austin, TX",
    "author_friend_count": 12,
    "author_review_count": 34,
    "useful_votes": 3,
    "funny_votes": 0,
    "cool_votes": 1,
    "owner_reply": {"text": "Sorry to hear that...", "date": "Aug 15, 2026", "author": "Aaron F."},
    "photos": ["https://s3-media0.fl.yelpcdn.com/bphoto/.../o.jpg"]
}

Input parameters

Parameter	Required	Description
businessUrls	No*	List of Yelp business URLs or slugs (e.g., "gary-danko-san-francisco" or "https://yelp.com/biz/gary-danko-san-francisco").
searchQueries	No*	Search queries to find businesses (e.g., ["best pizza new york", "plumber san francisco"]).
maxResults	No	Maximum businesses to scrape (1-500). Default 5. In reviews mode this caps the number of businesses visited.
mode	No	business (default) or reviews.
maxReviewsPerBusiness	No	Reviews mode. Reviews to return per business (1-1000). Default 20.
reviewSort	No	Reviews mode. relevance (default), newest, oldest, highest_rated, lowest_rated, elites.
ratings	No	Reviews mode. Keep only these star ratings, e.g. [1, 2, 3]. Empty = all.
proxyConfiguration	No	Proxy settings. Leave default for best results.

Example: 1-3 star reviews for two businesses

{
    "mode": "reviews",
    "businessUrls": ["franklin-barbecue-austin", "gary-danko-san-francisco"],
    "maxReviewsPerBusiness": 20,
    "reviewSort": "lowest_rated",
    "ratings": [1, 2, 3]
}

*At least one of businessUrls or searchQueries must be provided.

Use cases

• Lead generation: Build prospect lists of local businesses with phone, website, and address for cold outreach.
• Market research: Analyse business density, rating bands, and category mix in any US city.
• Competitor analysis: Benchmark ratings and review volumes across a named set of competitors.
• Review monitoring & sentiment: Pull the newest or lowest-rated reviews per location, feed them to an LLM for complaint themes, and track owner-reply rates.
• Local SEO: Audit Yelp listings at scale and track rating/review trends over time.
• Data enrichment: Append Yelp ratings, categories, and verified contact details to CRM records.
• Location intelligence: Use GPS coordinates to map businesses around a property or territory.

Limitations

• Primarily US-focused — Yelp's strongest market. International coverage is thin.
• Reviews mode returns the reviews Yelp shows publicly ("recommended" reviews); Yelp's hidden "not recommended" reviews are not included.
• A business page occasionally needs an automatic retry before it loads; this adds a few seconds and needs no action from you. If Yelp does not answer at all, the run stops quickly and is marked failed rather than returning an empty dataset.
• Some smaller businesses have incomplete data (missing hours, website, or coordinates).
• Search queries follow Yelp's own search ranking; sponsored listings are skipped. Yelp shows at most 240 results per search, so split very broad searches by city or neighborhood.
• Very new or unclaimed listings occasionally lack phone or website data on Yelp itself.
• A few businesses list a phone number on Yelp that is not their own line (for example a number from a different state). When the area code does not match the business's state, phone is left empty rather than risk a wrong number; the number Yelp shows is still available in yelp_listed_phone. Toll-free numbers are kept.

Compared to alternatives

• vs. yin/yelp-scraper (~$10/1K results): This actor is meaningfully cheaper at scale, with the same fields plus GPS coordinates and claimed status.
• vs. Yelp Fusion API: Fusion requires approval, rate-limits heavily, and doesn't expose claimed-status or full detail — this actor fills that gap for research and enrichment.

Pairs well with Google Maps Scraper and TripAdvisor Scraper for complete local-business intelligence.

FAQ

Can I just pass business names instead of Yelp URLs? Yes — use searchQueries. Each query runs a Yelp search (e.g. "plumber in Austin, TX") and the matching businesses are scraped. For known businesses, passing the alias directly via businessUrls is faster.

Does this include review text? Yes — set mode to reviews. Each row is one review with the full text, rating, date, author stats, votes, owner reply, and photos. The default business mode returns only the aggregate rating and review count.

Can I get only negative reviews? Yes — in reviews mode set ratings to [1, 2, 3] and reviewSort to lowest_rated so the matching reviews come first.

Can I scrape non-US businesses? Yelp does cover some international cities, but coverage and data quality drop significantly outside the US.

How fresh is the data? Pulled live at run time — as fresh as Yelp itself.

Last verified: 2026-10

More scrapers at thirdwatch.dev.