Yelp Business Details Scraper – Extract Complete Business Profile & Contact Data

Extract full business profiles from Yelp using business IDs, aliases, or URLs. Collect verified contact information, phone numbers, websites, physical addresses, GPS coordinates, operating hours, ratings, review counts, categories, popular dishes, and owner profiles. Built for B2B lead generation, local SEO research, and business directory enrichment with fast API integration.

---

Table of Contents

• Features
• What Data Can You Extract?
• Use Cases
• Quick Start
• Input Parameters
• Supported Business ID Formats
• Supported Yelp Domains
• Output Format
• Output Fields Explained
• Performance & Limits
• FAQ
• Troubleshooting
• Why Choose This Actor?
• Tags
• You May Also Like
• Get Started Now

---

Features

• Flexible Business Identifiers – Scrape using Yelp business IDs, alias slugs, or full Yelp URLs.
• High-Speed Batch Processing – Automatically batches and fetches details for up to 20 businesses per API request.
• Complete Contact & Location Data – Extract direct phone numbers, official websites, physical addresses, and precise GPS coordinates (latitude & longitude).
• Weekly Operating Hours – Capture complete day-by-day opening hours and regular schedules.
• Owner & Management Profiles – Extract owner names, profile photos, and owner bios/stories when available.
• Menus & Popular Dishes – Retrieve official Yelp menu links, external menu URLs, and crowdsourced popular dishes.
• Rich Business Categories & Attributes – Get structured categories (titles and aliases), price tier indicators ($, $$, $$$, $$$$), and neighborhood names.
• Ratings & Reputation Metrics – Get aggregate star ratings and total review counts for sentiment and popularity analysis.
• Multi-Country Coverage – Works across 35+ regional Yelp domains worldwide (US, UK, Canada, Germany, France, Australia, and more).
• Individual Error Reporting – Non-blocking execution; if an invalid business ID is submitted, it is flagged in the dataset while valid items continue processing seamlessly.
• Fast & Lightweight – Direct API-driven extraction without heavy browser overhead, keeping run costs minimal.

---

What Data Can You Extract?

Category	Extracted Data Points
🏢 Core Identity	Business name, Yelp alias slug, unique Yelp business ID
📍 Location & Geodata	Full street address, country code, latitude, longitude, neighborhoods
📞 Contact Channels	Phone number, official website URL
🔗 Links & Menus	Full Yelp page link, Yelp menu URL, external website menu URL
🏷️ Categorization	Category list (titles & aliases), concatenated category titles, price level ($, $$, $$$, $$$$)
⭐ Reputation	Star rating (1.0–5.0), total review count
🕒 Schedules	Weekly operating hours by day of the week with regular hours breakdown
👤 Ownership	Business owner name, owner avatar photo URL, owner biography
🍽️ Offerings & Media	Popular dishes list, high-resolution primary business photo
⏱️ Metadata	Source type, requested business ID, timestamp of scrape (scraped_at)

---

Use Cases

Use Case	Description	Key Benefits
B2B Lead Generation	Extract phone numbers, websites, and addresses for local sales outreach.	Fresh, verified local business contact information at scale.
Local SEO & Citation Audits	Audit NAP (Name, Address, Phone) consistency across local Yelp listings.	Spot discrepancies in business information and directory citations.
Competitive Intelligence	Compare competitor ratings, review volumes, operating hours, and price tiers.	Benchmark local competitors across markets and neighborhoods.
Market Research & Density Analysis	Map business distribution, popular categories, and pricing patterns across cities.	Structured geolocations (lat/long) ready for GIS and mapping tools.
CRM & Database Enrichment	Match existing business records to Yelp profiles to enrich missing data.	Append real-time websites, operating hours, and ratings to your CRM.
Restaurant & Food Intelligence	Collect menus, popular dishes, and owner backgrounds for food tech apps.	Actionable culinary data for food delivery and hospitality aggregators.
Directory Aggregation	Build or update regional directories, travel guides, and local discovery portals.	Multi-domain support covers 35+ countries and international markets.

---

Quick Start

1. Basic – Single Yelp Business by ID

{
  "business_ids": [
    "xDwEMq8kgT0eQepn90Jkvg"
  ]
}

---

Input Parameters

Parameter	Type	Required	Description	Default	Example
business_ids	Array of Strings	Yes	List of Yelp business IDs, aliases, or full Yelp URLs. Up to 20 IDs are processed per batch request.	["xDwEMq8kgT0eQepn90Jkvg"]	["xDwEMq8kgT0eQepn90Jkvg", "tartine-bakery-san-francisco"]
yelp_domain	String	No	The regional Yelp domain to query. Select from 35+ supported country domains.	"yelp.com"	"yelp.com", "yelp.co.uk", "yelp.ca", "yelp.de"

---

Supported Business ID Formats

You can supply business identifiers in any of the following formats — the scraper automatically recognizes and normalizes them:

Format	Input Example	Extracted Target
Yelp Business ID	"xDwEMq8kgT0eQepn90Jkvg"	xDwEMq8kgT0eQepn90Jkvg
Yelp Business Alias	"arizmendi-bakery-san-francisco"	arizmendi-bakery-san-francisco

---

Supported Yelp Domains

The actor supports 35+ regional Yelp country domains:

Region	Country	Domain
🇺🇸 United States	United States	yelp.com
🇬🇧 United Kingdom	United Kingdom	yelp.co.uk
🇨🇦 Canada (EN/FR)	Canada	yelp.ca / fr.yelp.ca
🇦🇺 Australia	Australia	yelp.com.au
🇳🇿 New Zealand	New Zealand	yelp.co.nz
🇩🇪 Germany	Germany	yelp.de
🇫🇷 France	France	yelp.fr
🇪🇸 Spain	Spain	yelp.es
🇮🇪 Ireland	Ireland	yelp.ie
🇧🇷 Brazil	Brazil	yelp.com.br
🇲🇽 Mexico	Mexico	yelp.com.mx
🇯🇵 Japan	Japan	yelp.co.jp
🇸🇬 Singapore	Singapore	yelp.com.sg
🇭🇰 Hong Kong	Hong Kong	en.yelp.com.hk / zh.yelp.com.hk
🇨🇭 Switzerland	Switzerland	de.yelp.ch / fr.yelp.ch / en.yelp.ch
🇦🇹 Austria	Austria	yelp.at
🇧🇪 Belgium	Belgium	en.yelp.be / fr.yelp.be
🇩🇰 Denmark	Denmark	yelp.dk
🇳🇴 Norway	Norway	yelp.no
🇸🇪 Sweden	Sweden	yelp.se
🇵🇱 Poland	Poland	yelp.pl
🇨🇿 Czech Republic	Czech Republic	yelp.cz
🇵🇭 Philippines	Philippines	en.yelp.com.ph / fil.yelp.com.ph
🇲🇾 Malaysia	Malaysia	en.yelp.my / ms.yelp.my
🇹🇼 Taiwan	Taiwan	yelp.com.tw
🇹🇷 Turkey	Turkey	yelp.com.tr

---

Output Format

Successful Business Details Record

{
  "source_type": "yelp_business_details",
  "business_id": "xDwEMq8kgT0eQepn90Jkvg",
  "requested_id": "xDwEMq8kgT0eQepn90Jkvg",
  "name": "Arizmendi Bakery",
  "alias": "arizmendi-bakery-san-francisco",
  "address": "1331 9th Ave\nSan Francisco, CA 94122",
  "country": "US",
  "latitude": 37.7633882,
  "longitude": -122.4664991,
  "phone": "+14155663117",
  "website": "http://www.arizmendibakery.com/",
  "menu_url": "https://store.arizmendibakery.com/menu-today",
  "business_page_link": "https://www.yelp.com/biz/arizmendi-bakery-san-francisco",
  "yelp_menu": "https://www.yelp.com/menu/arizmendi-bakery-san-francisco",
  "categories": [
    {
      "title": "Bakeries",
      "alias": "bakeries"
    },
    {
      "title": "Pizza",
      "alias": "pizza"
    }
  ],
  "category_titles": "Bakeries, Pizza",
  "price_range": "$",
  "neighborhoods": [
    "Inner Sunset"
  ],
  "rating": 4.5,
  "review_count": 2421,
  "photo": "https://s3-media0.fl.yelpcdn.com/bphoto/example-photo/l.jpg",
  "owner_name": "Worker-Owner A.",
  "owner_photo_url": "https://s3-media0.fl.yelpcdn.com/buphoto/example-owner/30s.jpg",
  "owner_biography": "We are a worker-owned cooperative specializing in artisan breads and pastries.",
  "operation_hours": [
    {
      "day_of_week": "Mon",
      "hours": ["Closed"],
      "regular_hours": ["Closed"]
    },
    {
      "day_of_week": "Tue",
      "hours": ["7:30 AM - 6:00 PM"],
      "regular_hours": ["7:30 AM - 6:00 PM"]
    },
    {
      "day_of_week": "Wed",
      "hours": ["7:30 AM - 6:00 PM"],
      "regular_hours": ["7:30 AM - 6:00 PM"]
    },
    {
      "day_of_week": "Thu",
      "hours": ["7:30 AM - 6:00 PM"],
      "regular_hours": ["7:30 AM - 6:00 PM"]
    },
    {
      "day_of_week": "Fri",
      "hours": ["7:30 AM - 6:00 PM"],
      "regular_hours": ["7:30 AM - 6:00 PM"]
    },
    {
      "day_of_week": "Sat",
      "hours": ["7:30 AM - 6:00 PM"],
      "regular_hours": ["7:30 AM - 6:00 PM"]
    },
    {
      "day_of_week": "Sun",
      "hours": ["7:30 AM - 6:00 PM"],
      "regular_hours": ["7:30 AM - 6:00 PM"]
    }
  ],
  "popular_dishes": [
    "focaccia",
    "pecan-rolls",
    "brioche-knots-and-chocolate-things"
  ],
  "scraped_at": "2026-09-08T10:00:00.000Z"
}

Error Item Structure

If a business is not found or fails to load, the scraper produces a dedicated error record so your batch run continues smoothly without losing data:

{
  "source_type": "yelp_business_details",
  "business_id": "invalid-business-id",
  "error": true,
  "error_message": "Business not found in API response. Please check the business ID or alias.",
  "scraped_at": "2026-09-08T10:00:00.000Z"
}

---

Output Fields Explained

Field	Type	Description
source_type	String	Data source identifier, always yelp_business_details.
business_id	String	Yelp business unique ID or normalized identifier.
requested_id	String	The exact identifier provided in the input list for easy matching.
name	String	Official display name of the business.
alias	String	Yelp URL slug / alias for the business.
address	String	Formatted physical street address with city, state, and postal code.
country	String	Two-letter ISO country code (e.g., US, GB, CA).
latitude	Number	Geographic latitude coordinate for mapping and routing.
longitude	Number	Geographic longitude coordinate for mapping and routing.
phone	String	Formatted business phone number for customer contact.
website	String	Official website URL of the business.
menu_url	String	External online menu or order link.
yelp_menu	String	Yelp-hosted menu page URL.
business_page_link	String	Direct URL to the business page on Yelp.
photo	String	High-resolution primary photo URL of the business.
categories	Array	List of category objects containing both title and alias.
category_titles	String	Comma-separated list of category titles for easy spreadsheet filtering.
price_range	String	Price affordability tier ($, $$, $$$, $$$$).
neighborhoods	Array	List of local neighborhoods where the business is situated.
rating	Number	Average star rating on Yelp (1.0 to 5.0).
review_count	Number	Total count of published customer reviews.
owner_name	String	Name of the registered business owner or manager.
owner_photo_url	String	Avatar photo URL of the business owner.
owner_biography	String	Biography or story written by the business owner.
operation_hours	Array	Full 7-day schedule with day-of-week and opening/closing hours.
popular_dishes	Array	List of top popular dishes or signature items.
scraped_at	String	ISO 8601 UTC timestamp of when the record was extracted.

---

Performance & Limits

• Smart Batching – Automatically splits your input list into optimal batches of up to 20 business IDs per API request.
• Non-Blocking Resilience – One invalid ID never crashes your run; valid businesses are extracted and bad IDs are saved as error items.
• Dataset Streaming – Flushes results into the Apify dataset in increments of 10 items, preventing data loss during long runs.
• Export Options – Download your dataset anytime as CSV, Excel (XLSX), JSON, XML, or HTML.

---

FAQ

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

  • There is no upper limit. You can submit dozens or hundreds of business IDs. The actor automatically splits them into batches of 20 and processes them in sequence.

• Q: What is the difference between a Yelp ID and an alias?

  • A Yelp ID is a unique hash-like string (e.g., xDwEMq8kgT0eQepn90Jkvg), whereas an alias is the human-readable slug from the URL (e.g., arizmendi-bakery-san-francisco). Both formats work interchangeably.

• Q: Can I scrape businesses from non-US Yelp domains?

  • Yes. Select the appropriate regional domain from the yelp_domain dropdown (e.g., yelp.co.uk for the UK, yelp.ca for Canada, yelp.de for Germany).

• Q: Does this actor require proxies?

  • No external proxy setup is required. The actor communicates directly with the high-speed Yelp business data API with built-in key management.

• Q: What happens if a business has closed or changed its URL?

  • If a business ID is not found, an error record with error: true and the specific error message is saved into your dataset, ensuring full auditability.

• Q: In which formats can I export the data?

  • You can export the collected dataset directly from the Apify Console as JSON, CSV, Excel (XLSX), XML, or HTML.

---

Troubleshooting

Issue	Potential Cause	Recommended Solution
"No business ID provided"	Empty or missing business_ids array in input	Provide at least one valid Yelp business ID, alias, or URL.
"Business not found in API response"	Invalid ID, typo in alias slug, or wrong regional domain	Verify the business slug on Yelp, or try switching the yelp_domain setting.
"Rate limit exceeded"	High volume of concurrent requests	The actor automatically retries; for custom limits, contact Apify support or run in off-peak hours.
Missing owner details or menu	The business has not published owner info or menus on Yelp	Fields remain null or empty arrays if the business has not provided them on Yelp.
Different hours on holidays	Holiday hours vs regular hours	The actor extracts standard regular_hours; special holiday overrides may vary on Yelp.

---

Why Choose This Actor?

• ⚡ Lightning Fast – API-driven architecture completes in seconds per batch, unlike slow browser automation.
• 💰 Cost-Effective – Consumes minimal Apify Compute Units (CU) because no headless browser is required.
• 🎯 Comprehensive Profiles – Scrapes phone, website, coordinates, hours, owner bios, and menus all at once.
• 🛡️ Fail-Safe Processing – Fault-tolerant execution guarantees you get data for every valid ID in your list.
• 🌍 Global Coverage – Seamlessly queries 35+ international Yelp domains with a single configuration setting.
• 📊 Spreadsheet Ready – Outputs clean, flattened JSON and CSV-ready columns with combined category strings.

---

Tags

yelp, yelp scraper, yelp business scraper, yelp business details, yelp data extractor, yelp phone scraper, yelp contact scraper, b2b lead generation, local seo, business directory, restaurant scraper, opening hours scraper, business leads, apify actor

---

You May Also Like

Actor	Description
Yelp Business Search	Search Yelp businesses by keyword and location with filters for price and rating.
Yelp Business Reviews	Scrape all reviews, ratings, photos, and author profiles from any Yelp business.
Yelp Business Scraper	Scrape detailed Yelp business data by URL.

---

Get Started Now

1. Click "Try for free" to test the actor
2. Enter one or more Business IDs.
3. Select your target Yelp Domain (leave as yelp.com for US businesses).
4. Click Start to run the actor.
5. Export your structured data in JSON, CSV, or Excel format.

---

Built using Apify Platform | Optimized for Performance & Reliability