Yelp Business Scraper

Extract business data from Yelp — names, phones, websites, ratings, reviews, and more. Bypasses Yelp's limited search interface and gives you structured data ready for lead lists, CRM imports, or competitive analysis.

Use Cases

Lead Generation: Pull business names, phone numbers, websites, and addresses by keyword and location. Export straight to CSV for cold outreach or import into HubSpot/Salesforce.

Competitor Tracking: Monitor ratings, review counts, and category positioning across any market. See who's gaining reviews and who's slipping.

Local Market Research: Map out business density by category in any city. Find gaps — neighborhoods without a coffee shop, zip codes underserved by dentists.

---

Input

Provide either a search query (keyword + location) or a list of direct Yelp business URLs.

Field	Type	Description
searchTerm	string	What to search for (e.g., "plumbers")
location	string	City, state, or zip code (e.g., "Austin, TX")
maxResults	integer	Max businesses to return (default: 30)
urls	array	Direct Yelp business URLs — bypasses search
extractReviews	boolean	Also pull top reviews per business
proxyConfiguration	object	Apify proxy settings (recommended)

Search Tips

• Be specific with locations. "Austin, TX" works better than just "Austin."
• Use urls mode when you already have a list of Yelp pages — faster than searching.
• Set extractReviews: true if you need sentiment data, but expect 2-3x slower runs.

---

Output

Each result is a business profile with contact info, ratings, and operational details.

Core Fields

• name, url, phone, website — the basics
• address, city, state, zipCode, neighborhood — full address breakdown
• latitude, longitude — for mapping or geo-analysis
• rating, reviewCount — current Yelp score
• categories — Yelp category tags (e.g., ["Coffee & Tea", "Breakfast"])
• priceRange — $, $$, $$$, or $$$$
• hours — opening hours by day

Review Data (when extractReviews is enabled)

• reviews[] — array of top reviews with author, rating, text, date

JSON Example

{
  "url": "https://www.yelp.com/biz/joes-coffee-san-francisco",
  "name": "Joe's Coffee",
  "phone": "(415) 555-0123",
  "website": "https://joescoffee.com",
  "address": "123 Market St",
  "city": "San Francisco",
  "state": "CA",
  "zipCode": "94102",
  "neighborhood": "Financial District",
  "rating": 4.5,
  "reviewCount": 342,
  "categories": ["Coffee & Tea", "Breakfast & Brunch"],
  "priceRange": "$$",
  "hours": {"Monday": "7:00 AM - 7:00 PM", "Tuesday": "7:00 AM - 7:00 PM"},
  "latitude": 37.7749,
  "longitude": -122.4194
}

---

Integrations & API

• Zapier / Make: Pipe results directly into Google Sheets, Airtable, or your CRM.
• API Access: Use the Apify Python (apify-client on PyPI) or Node.js (apify-client on NPM) client.
• Scheduling: Set up recurring runs to track rating changes over time.

---

FAQ

Is this legal? The scraper only collects publicly available data from Yelp. You're responsible for complying with Yelp's Terms of Service and applicable data privacy laws.

How fast is it? A search for 30 results takes about 15-30 seconds. Larger runs (500+) take 2-5 minutes depending on proxy speed.

Why use this instead of Yelp's API? Yelp's Fusion API returns limited fields and has strict rate limits. This scraper gives you full business profiles, reviews, and hours — no API key needed.

Can I scrape reviews? Yes. Enable extractReviews to pull the top reviews for each business. Set a higher memory allocation (4GB+) for review-heavy runs.

---

Support

For bugs or feature requests, open an issue in the Issues tab on this Actor's page.