Yelp Business Details Scraper

🏪 Yelp Business Details Scraper – Extract Complete Business Data from Yelp

🚀 Scrape complete details of any Yelp business by alias, ID, or URL. Extract name, address, phone, website, hours, ratings, reviews, categories, attributes, amenities, popular dishes, health inspections, photos, vibe, and 50+ data fields. Built with Apify best practices for reliability and speed.

📋 Table of Contents

• ✨ Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 📊 Output Fields
• ❓ FAQ
• 🛠️ Troubleshooting
• 🏷️ Tags

---

✨ Features

• Flexible Input – Accepts Yelp business alias, 22-character business ID, or any yelp.com business URL
• 50+ Data Fields – Extracts comprehensive business data including name, address, phone, website, and more
• Ratings & Reviews – Rating, review count, star rating distribution, not-recommended review count
• Business Hours – Weekly hours, special hours, holiday closures, open/closed status
• Popular Dishes – Dish names, ratings, review counts, photos for restaurants and food businesses
• Health Inspections – Inspection scores, dates, and violation details
• Photos & Vibe – Primary photo, exterior photo, interior/outside photo groups with tags
• Attributes & Amenities – Full list of 40+ business attributes and amenities with availability
• Categories & Price – Business categories with hierarchy, price range, and price level
• Contact & Location – Phone, website, full address, neighborhoods, coordinates, timezone
• Menu Links – Yelp menu URL and external menu links
• Business Status – Claimed status, closed status, advertiser status, online ordering
• Messaging Info – Messaging availability, response rate, and response time
• About Section – Business specialties, history, year established, owner info
• Alternate Links – Yelp URLs for different locales (US, UK, Canada, etc.)
• Resilient – Retries, key rotation, rate-limit handling, and clear error messages

---

🎯 Use Cases

Use Case	Description	Key Benefits
Restaurant Research	Scrape restaurant details, menus, popular dishes, and health inspections	Compare restaurants, find top-rated dishes, check hygiene scores
Business Intelligence	Extract complete Yelp business profiles for market analysis	Competitive analysis, market research, location intelligence
Lead Generation	Collect business contact info – phone, website, address from Yelp	Sales prospecting, B2B outreach, local business targeting
Review & Rating Analysis	Get review counts, star distributions, and rating breakdowns	Sentiment tracking, reputation monitoring, trend analysis
Local SEO Research	Analyze Yelp business listings for SEO and citation audit	NAP consistency check, competitor keyword analysis
Real Estate Analysis	Extract business data by neighborhood and location	Area profiling, foot traffic estimation, commercial analysis
Food & Hospitality Insights	Scrape popular dishes, amenities, price range, and vibe	Menu analysis, dining trend research, hospitality benchmarking

---

⚡ Quick Start

Basic – Single Business URL

{
    "business_urls": [
        "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
    ]
}

Using Business Alias

{
    "business_urls": [
        "tartine-bakery-san-francisco-3"
    ]
}

Using Business ID

{
    "business_urls": [
        "ri7UUYmx21AgSpRsf4-9QA"
    ]
}

Multiple Businesses at Once

{
    "business_urls": [
        "https://www.yelp.com/biz/tartine-bakery-san-francisco-3?osq=Bakeries",
        "tartine-bakery-san-francisco-3",
        "ri7UUYmx21AgSpRsf4-9QA"
    ]
}

---

📊 Input Parameters

Parameter	Type	Required	Description	Example
business_urls	Array of Strings	Yes	One or more Yelp business aliases, IDs, or URLs to scrape	"tartine-bakery-san-francisco-3", "ri7UUYmx21AgSpRsf4-9QA", "https://www.yelp.com/biz/..."

Supported Input Formats

• Business Alias: "tartine-bakery-san-francisco-3"
• Business ID (22 chars): "ri7UUYmx21AgSpRsf4-9QA"
• Yelp URL: "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
• Yelp URL with query: "https://www.yelp.com/biz/tartine-bakery-san-francisco-3?osq=Bakeries"

---

📤 Output Format

Business Data Structure

{
    "id": "ri7UUYmx21AgSpRsf4-9QA",
    "alias": "tartine-bakery-san-francisco-3",
    "name": "Tartine Bakery",
    "link": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3",
    "summary": "Neighborhood bakery known for flaky chocolate croissants and rich banana cream pie.",
    "rating": 4.2,
    "review_count": 9211,
    "not_recommended_review_count": 1536,
    "rating_distribution": { "1": 332, "2": 462, "3": 1101, "4": 2748, "5": 4575 },
    "photo_count": 9319,
    "price_range": "$$",
    "price_level": 2,
    "categories": [
        { "alias": "bakeries", "title": "Bakeries", "root_alias": "food", "path": ["Food", "Bakeries"] }
    ],
    "phone": "(415) 487-2600",
    "website": { "link": "https://tartinebakery.com/san-francisco/bakery", "display_link": "https://tartinebakery.com", "is_verified": true },
    "address": { "line1": "600 Guerrero St", "city": "San Francisco", "state": "CA", "postal_code": "94110", "country_code": "US", "formatted": "600 Guerrero St, San Francisco, CA 94110" },
    "neighborhoods": ["Mission"],
    "coordinates": { "latitude": 37.76166451, "longitude": -122.42424233 },
    "timezone": "America/Los_Angeles",
    "hours": { "is_open_now": false, "weekly": [...], "holidays": [...] },
    "attributes": { "accepts_apple_pay": true, "has_outdoor_seating": true, "offers_delivery": true, ... },
    "amenities": [...],
    "vibe": { "tags": ["Moderate noise", "Classy", "Casual"], "photo_groups": [...] },
    "popular_dishes": [
        { "name": "Morning Bun", "rating": 4.29, "review_count": 2087, "photo_count": 565, "photo": {...} }
    ],
    "menu": { "yelp_link": null, "external_link": "https://tartinebakery.com/..." },
    "about": { "specialties": "A humble beginnings bakery...", "history": null, "year_established": null },
    "health_inspections": [
        { "score": "Pass", "date": "2026-01-29", "violations": [...] }
    ],
    "primary_photo": { "id": "...", "link": "https://s3-media0.fl.yelpcdn.com/...", ... },
    "exterior_photo": { "id": "...", "link": "https://s3-media0.fl.yelpcdn.com/...", ... },
    "is_closed": false,
    "is_claimed": true,
    "alternate_links": [
        { "locale": "en_US", "link": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3" }
    ],
    "input_query": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3?osq=Bakeries",
    "scraped_at": "2026-10-27T14:00:00.000Z"
}

---

📊 Output Fields

Field	Type	Description
id	String	Unique Yelp business ID (22 characters)
alias	String	Business alias/slug used in Yelp URLs
name	String	Business display name
link	String	Direct Yelp business page URL
alternate_names	Array	Alternative business names (if any)
summary	String	Short AI-generated business description
rating	Number	Average star rating (1.0 – 5.0)
review_count	Integer	Total number of reviews
not_recommended_review_count	Integer	Count of filtered/not-recommended reviews
rating_distribution	Object	Breakdown of ratings by star (1–5)
photo_count	Integer	Total number of business photos
price_range	String	Price range string (e.g., "$", "$$", "$$$")
price_level	Integer	Numeric price level (1–4)
categories	Array	Business categories with alias, title, root category, and path
phone	String	Business phone number
tracked_phone	String	Tracked/forwarding phone number (if any)
website	Object	Website URL, display link, and verification status
address	Object	Full address – line1, line2, city, state, postal code, country, formatted
neighborhoods	Array	List of neighborhoods the business is located in
coordinates	Object	GPS coordinates – latitude and longitude
timezone	String	Business timezone (e.g., "America/Los_Angeles")
service_area	Object	Service area details (for service-area businesses)
hours	Object	Weekly hours, special hours, holiday closures, last updated
attributes	Object	20+ business attributes – parking, wifi, alcohol, noise level, ambience, etc.
amenities	Array	40+ amenities with name, alias, and availability status
vibe	Object	Vibe tags and photo groups (interior, outside) with photos
popular_dishes	Array	Popular menu items with name, rating, review count, photo count
menu	Object	Yelp menu link and external menu URL
has_online_ordering	Boolean	Whether the business supports online ordering
messaging	Object	Messaging status, response rate, and response time
about	Object	Business specialties, history, year established, owner details
services	Array	List of business services offered
portfolio	Array	Business portfolio items
licenses	Array	Business licenses
health_inspections	Array	Health inspection scores, dates, violations, and provider info
consumer_alert	Object	Active consumer alert (if any)
primary_photo	Object	Main business photo with ID, link, thumbnail, caption
exterior_photo	Object	Exterior/storefront photo
is_closed	Boolean	Whether business is permanently closed
closed_until	String	Temporary closure date (if applicable)
is_claimed	Boolean	Whether business profile is claimed on Yelp
is_claimable	Boolean	Whether the business can be claimed
has_storefront	Boolean	Whether business has a physical storefront
is_online_business	Boolean	Whether it's an online-only business
is_multi_location	Boolean	Whether business has multiple locations
is_yelp_advertiser	Boolean	Whether business is a Yelp advertiser
is_yelp_guaranteed	Boolean	Whether business has Yelp Guaranteed badge
alternate_links	Array	Yelp URLs for different locales (US, UK, CA, etc.)
input_query	String	The original input query used to fetch this business
scraped_at	String	ISO 8601 timestamp when the data was scraped

---

❓ FAQ

• Q: What input formats does this Yelp scraper accept?

  • You can use a Yelp business alias (e.g., tartine-bakery-san-francisco-3), a 22-character business ID (e.g., ri7UUYmx21AgSpRsf4-9QA), or a full Yelp URL (e.g., https://www.yelp.com/biz/tartine-bakery-san-francisco-3). All three formats work.

• Q: How many businesses can I scrape in one run?

  • You can add as many business URLs, aliases, or IDs as you want in the business_urls array. Each business is fetched individually with a small delay between requests.

• Q: Does this scraper work for businesses outside the US?

  • Yes! The scraper works for any Yelp business worldwide. Yelp URLs from any locale (yelp.com, yelp.ca, yelp.co.uk, etc.) are supported.

• Q: What data is included for restaurants vs other businesses?

  • Restaurants typically include popular dishes, health inspections, menu links, and food-specific attributes. Other business types include services, portfolios, and industry-specific amenities. The API returns all available data for each business type.

• Q: Can I get business photos?

  • Yes. The output includes primary photo, exterior photo, and vibe photo groups (interior/outside) with full-resolution URLs and thumbnails.

• Q: What happens if a business is not found?

  • The actor will return an error record with error: true and a clear error_message explaining the issue. Other businesses in the same run will continue processing.

• Q: Does this extract reviews?

  • This scraper extracts review metadata (count, rating distribution, not-recommended count) but not individual review text. Use a dedicated Yelp Reviews Scraper for full review content.

---

🛠️ Troubleshooting

Issue	Cause	Solution
"No business URL/ID provided"	Empty or missing business_urls	Add at least one Yelp business alias, ID, or URL
"Business not found"	Invalid alias, ID, or URL	Double-check the business identifier on yelp.com
No data returned	Business page removed or unavailable	Verify the business exists on Yelp
Rate limit exceeded	Too many requests in a short period	Wait a few minutes and retry; built-in key rotation handles most cases
Request timeout	Network or API server issues	Retry the run; the actor has built-in retry and key rotation logic
Missing fields in output	Some data not available on Yelp	Not all businesses have all fields (e.g., popular dishes, health inspections)

---

🏷️ Tags

yelp scraper, yelp business scraper, yelp business details, yelp data extractor, yelp api, yelp business data, scrape yelp, yelp restaurant scraper, yelp reviews scraper, yelp ratings scraper, yelp hours scraper, yelp phone number extractor, yelp address scraper, yelp categories scraper, yelp popular dishes, yelp health inspection, yelp amenities, yelp attributes, yelp business photos, yelp menu scraper, yelp price range, yelp coordinates, yelp neighborhood, yelp business hours, yelp business info, local business scraper, restaurant data scraper, business listing scraper, yelp lead generation, yelp competitor analysis, apify actor, yelp data extraction tool

---

🚀 Get Started Now

Ready to scrape Yelp business details?

1. Enter one or more Yelp business URLs, aliases, or IDs
2. Click Start to run the actor
3. Download your data in JSON, CSV, Excel, or HTML format
4. Click "Try for free" to test the actor

If this actor helps your workflow, please give it a ⭐ star!

---

Built with Apify Platform