Yelp Business Data Scarper ⚡

High-accuracy Yelp Business Data Scarper to extract business listings, categories, detailed profiles, menus, popular dishes, reviews, and URL-to-ID mapping at scale. Built as an Apify Actor for reliability, speed, and easy configuration.

Target keyword: Yelp Business Data Scarper

Related keywords: Yelp scraper, Yelp business scraper, Yelp reviews scraper, Yelp categories, Yelp menus, Yelp data extraction, local business data, local SEO data, Yelp crawler.

---

Why choose this scraper? 🚀

• Comprehensive coverage: Search by term/location, category search, per-business details, menus, popular dishes, and reviews.
• Reliable at scale: Retries, batching, and stable selectors tailored to Yelp’s structure.
• Clean structured outputs: JSON ready for analytics, CRM enrichment, lead gen, and BI dashboards.
• Modular endpoints: Enable only the modules you need to control costs and speed.

---

Table of Contents 📚

• Features
• How it works
• Input configuration
• Example inputs
• Example outputs
• Use cases
• Best practices
• FAQ
• Changelog

---

Features ✨

Module	What you get	Input switches
Search	Business listings by location + term	search_enabled, search_location, search_term, search_*
Category search	Listings by Yelp category + location	category_search_enabled, category_location, category_search_category, category_*
Business by URL (each)	Detailed profile for given Yelp business URLs	each_enabled, each_business_urls
Reviews	Reviews for a business by URL or business ID	reviews_enabled, reviews_business_url, reviews_business_id, reviews_*
Menus	Menu data for businesses by ID	menus_enabled, menus_business_ids
Popular dishes	Popular dishes data for businesses by ID	popular_dish_enabled, popular_dish_business_ids
Biz URL ➜ ID	Convert Yelp business URLs to business IDs	biz_url2id_enabled, biz_url2id_urls

This Yelp Business Data Scarper is perfect for lead generation, local SEO, market research, competitor analysis, and data enrichment.

---

How it works 🧠

• The Actor reads your inputs defined in input_schema.json and runs only the enabled modules.
• Each module makes requests to the relevant Yelp pages or endpoints, handling pagination and retries.
• Data is normalized to consistent JSON and pushed to the default Apify dataset.

---

Input configuration ⚙️

Below is a quick reference matching the current schema in input_schema.json.

Group	Key	Type	Default	Description
Search	search_enabled	boolean	false	Toggle search by term and location
	search_location	string	""	Location, e.g. New York, NY
	search_term	string	""	Keyword, e.g. restaurants
	search_limit	integer	50	Max results to return
	search_offset	integer	0	Pagination offset
	search_business_details_type	string	basic	Details level hint (implementation-specific)
Category	category_search_enabled	boolean	false	Toggle category-based search
	category_location	string	""	Location for category search
	category_search_category	string	""	Yelp category name
	category_limit	integer	50	Max results to return
	category_offset	integer	0	Pagination offset
	category_business_details_type	string	basic	Details level hint
Business (each)	each_enabled	boolean	false	Toggle per-business detail fetch
	each_business_urls	array[string]	[]	List of Yelp business page URLs
Reviews	reviews_enabled	boolean	false	Toggle reviews scraping
	reviews_business_url	string	""	Yelp business URL (optional if ID provided)
	reviews_business_id	string	""	Yelp business ID (optional if URL provided)
	reviews_per_page	integer	20	Reviews per page fetch
	reviews_sort_by	enum[string]	Yelp_sort	Sort order selector
	reviews_rating_filter	enum[string]	All_ratings	Rating filter selector
Menus	menus_enabled	boolean	false	Toggle menu scraping
	menus_business_ids	array[string]	[]	Yelp business IDs for menus
Popular dishes	popular_dish_enabled	boolean	false	Toggle popular dishes scraping
	popular_dish_business_ids	array[string]	[]	Yelp business IDs for popular dishes
Biz URL ➜ ID	biz_url2id_enabled	boolean	false	Toggle URL-to-ID conversion
	biz_url2id_urls	array[string]	[]	Yelp business URLs to convert

Tip: Use the prefilled examples in the Apify UI to get started quickly.

---

Example inputs 📥

1) Search businesses by location + term

{
  "search_enabled": true,
  "search_location": "New York, NY",
  "search_term": "restaurants",
  "search_limit": 50
}

2) Category search

{
  "category_search_enabled": true,
  "category_location": "New York, NY",
  "category_search_category": "Vacation Rental Agents",
  "category_limit": 50
}

3) Business details by URL list

{
  "each_enabled": true,
  "each_business_urls": [
    "https://www.yelp.com/biz/pizza-paradise-new-york",
    "https://www.yelp.com/biz/joes-coffee-san-francisco"
  ]
}

4) Reviews with sorting and rating filter

{
  "reviews_enabled": true,
  "reviews_business_url": "https://www.yelp.com/biz/pizza-paradise-new-york",
  "reviews_per_page": 20,
  "reviews_sort_by": "Yelp_sort",
  "reviews_rating_filter": "All_ratings"
}

5) Menus and Popular dishes by business IDs

{
  "menus_enabled": true,
  "menus_business_ids": ["pizza-paradise-new-york"],
  "popular_dish_enabled": true,
  "popular_dish_business_ids": ["pizza-paradise-new-york"]
}

6) Convert Business URLs to IDs

{
  "biz_url2id_enabled": true,
  "biz_url2id_urls": [
    "https://www.yelp.com/biz/pizza-paradise-new-york"
  ]
}

---

Example outputs 📤

Outputs are pushed to the default Apify dataset.

• Search/Category item

{
  "source": "search",
  "location": "New York, NY",
  "term": "restaurants",
  "business": {
    "id": "pizza-paradise-new-york",
    "name": "Pizza Paradise",
    "rating": 4.6,
    "review_count": 389,
    "price": "$$",
    "categories": ["Pizza", "Italian"],
    "phone": "+1 212-555-0123",
    "address": "123 5th Ave, New York, NY",
    "url": "https://www.yelp.com/biz/pizza-paradise-new-york"
  }
}

• Business details (each)

{
  "source": "each",
  "url": "https://www.yelp.com/biz/pizza-paradise-new-york",
  "details": {
    "hours": [{"day": "Mon", "open": "10:00", "close": "22:00"}],
    "photos": ["https://.../photo1.jpg"],
    "attributes": {"takes_reservations": true, "outdoor_seating": true}
  }
}

• Reviews

{
  "source": "reviews",
  "business_id": "pizza-paradise-new-york",
  "sort_by": "Yelp_sort",
  "rating_filter": "All_ratings",
  "items": [
    {"user": "John D.", "rating": 5, "date": "2025-01-02", "text": "Amazing slices!"}
  ]
}

• Menus

{
  "source": "menus",
  "business_id": "pizza-paradise-new-york",
  "sections": [{"name": "Pizzas", "items": [{"name": "Margherita", "price": 14.99}]}]
}

• Popular dishes

{
  "source": "popular_dishes",
  "business_id": "pizza-paradise-new-york",
  "items": [{"name": "Truffle Pizza", "mentions": 128}]
}

• Biz URL ➜ ID

{
  "source": "biz_url2id",
  "url": "https://www.yelp.com/biz/pizza-paradise-new-york",
  "business_id": "pizza-paradise-new-york"
}

---

Use cases 💼

• Lead generation: Build prospect lists with phone, address, and categories.
• Local SEO: Track categories, ratings, and reviews for competitors.
• Menu analysis: Compare pricing and offerings across locations.
• Data enrichment: Append Yelp metadata to your CRM or BI warehouse.

---

Best practices 🧩

• Start small with a limited search_limit to validate output shape.
• Combine modules thoughtfully: e.g., run Search -> store IDs -> run Menus/Reviews for those IDs.
• Respect Yelp: Avoid excessive concurrency; use retries and sensible pacing.

---

FAQ ❓

• Do I need API keys?
  No. This Actor works on publicly available Yelp data.

• Where do results go?
  To the run’s default Apify dataset as JSON items.

• Can I filter reviews?
  Yes, choose reviews_sort_by and reviews_rating_filter from dropdowns in the input UI.

• Can I run only URL-to-ID?
  Yes, set biz_url2id_enabled: true and provide biz_url2id_urls.

• What if I only have business IDs?
  Use menus_business_ids and/or popular_dish_business_ids to fetch menus and dishes.

---

Changelog 📦

• Initial release of Yelp Business Data Scarper Actor with modules for Search, Category search, Business details (each), Reviews, Menus, Popular dishes, and URL ➜ ID conversion.

---