Yelp Real-Time Data

Turn Yelp into a clean, structured data feed. Search businesses, pull complete company profiles, collect reviews and photos, browse by category, and discover events — all returned as ready-to-use JSON. Built for lead generation, market research, competitive analysis, and AI/LLM pipelines.

No manual copy-paste. No brittle spreadsheets. Just point it at what you need and get structured results streamed straight to your dataset (and optionally to your own webhook in real time).

---

Why use this actor

• 🔎 Find businesses at scale — search any keyword in any location and get back names, ratings, review counts, categories, and locations.
• 📇 Complete contact profiles — phone numbers, websites, addresses, hours, amenities, social links, and more.
• ✉️ Email discovery — optionally enrich each business with an email address found on its official website.
• ⭐ Full reviews — review text, author, star rating, date, and photos, with pagination.
• 🖼️ Photos — high-resolution business photo URLs with captions and metadata.
• 🗂️ Category browsing — pull every business under a category in a city.
• 🎫 Events — discover local events with venue, date, and category.
• ⚡ Fast & reliable — runs feature workloads in parallel and streams results as they are produced.
• 🔌 Real-time delivery — push every record to your CRM, Slack, Zapier, Make, or Google Sheets via webhook.
• 🤖 AI-ready — clean, predictable schemas that drop straight into LLM and agent workflows (MCP-compatible).

---

What can you build with it?

Goal	How this actor helps
Lead generation	Search a niche + city, enrich with phone, website, and email, filter by rating/reviews, export to your CRM.
Market & competitor research	Pull every competitor in an area with ratings, price level, categories, and review volume.
Reputation monitoring	Collect the latest reviews for a set of businesses on a schedule and route them to Slack.
Local SEO & directories	Build and keep a local business directory fresh with complete, structured profiles.
Data enrichment	Feed a list of Yelp URLs or business IDs and get back full, normalized company records.
AI agents & RAG	Give an LLM live, structured local-business context through clean JSON or MCP.

---

Features

Pick one feature per run using the checkboxes in the input form. Business Search is enabled by default.

Feature	What it does
Business Search	Search by keyword + location (e.g. dentists :: Miami, FL).
Business Details	Full company profile for one or many businesses (URL, alias, or ID).
Business Reviews	Review text, author, rating, date, and photos — with pagination.
Business Photos	Business photo URLs with captions and metadata.
Category Browse	Every business under a category in a location, with optional subcategories.
Events	Local events with venue, date range, and category.
Scrape By URL	Paste any Yelp URL (business, search, category, or events) — it auto-detects the type.
Full Pipeline	Search → automatically enrich every result into complete profiles (and optional reviews) in one run.

---

Quick start

1. Open the actor and leave Business Search enabled.
2. The Search queries field is pre-filled with dentists :: Miami, FL — change it or add more.
3. Click Start. Results stream to the Dataset tab and can be exported as JSON, CSV, or Excel.

Every feature comes with example values pre-filled, so you can switch a feature on and run it immediately to see the output shape.

---

Input

You control the actor through the input form (or the API). Below are the most important fields; each feature has its own group of options in the form with inline help.

Core

Field	Type	Description
locale	string	Target Yelp locale (default US).
maxItems	integer	Fallback cap per feature when a feature-specific limit is not set.
includeEmailFromWebsite	boolean	Visit each business's website to discover an email address.
filterPreset	string	Apply a ready-made filter bundle (or none).
webhookUrl	string	Optional. Also POST each record to this URL in real time.
webhookFormat	string	json (full record) or slack (ready-to-post message).

Business Search

Field	Type	Example
enableBusinessSearch	boolean	true
searchQueries	string[]	["dentists :: Miami, FL", "plumbers :: Austin, TX"]
searchKeywords + searchLocations	string[]	Cross-product alternative to searchQueries
searchMaxResultsPerQuery	integer	20
searchEnrichContacts	boolean	Fetch phone, website, and optional email per result

Business Details

Field	Type	Example
enableBusinessDetails	boolean	true
businessUrls	string[]	["https://www.yelp.com/biz/franklin-barbecue-austin"]
businessAliases	string[]	["franklin-barbecue-austin"]
encBizIds	string[]	Encoded business IDs for the fastest lookups

Reviews / Photos

Field	Type	Example
enableBusinessReviews / enableBusinessPhotos	boolean	true
reviewsBusinessUrls / photosBusinessUrls	string[]	["https://www.yelp.com/biz/franklin-barbecue-austin"]
reviewsMaxPerBusiness / photosMaxPerBusiness	integer	25
reviewsSortBy	string	DATE_DESC, RELEVANCE_DESC, …

Category / Events / Scrape / Pipeline

Field	Type	Example
categoryNames + categoryLocation	string[] / string	["Plumbers"] + "Denver, CO"
eventsLocation	string	"Paris"
scrapeUrls	string[]	Any Yelp URLs — type auto-detected
pipelineQueries	string[]	["dentists :: Phoenix, AZ"]

Filtering (works across features)

Filter results server-side so you only pay for and store what you want:

filterMinRating, filterMaxRating, filterMinReviewCount, filterRequirePhone, filterRequireWebsite, filterRequireEmail, filterExcludeClosed, filterExcludeAds, filterCategoriesInclude, filterCategoriesExclude, filterMinCompletenessScore.

Example input

{
  "enableBusinessSearch": true,
  "searchQueries": ["coffee shops :: Seattle, WA"],
  "searchMaxResultsPerQuery": 25,
  "searchEnrichContacts": true,
  "includeEmailFromWebsite": true,
  "filterMinRating": 4,
  "filterRequirePhone": true,
  "webhookUrl": "https://hooks.zapier.com/hooks/catch/123/abc"
}

---

Output

Every record is saved to the run's dataset and can be exported as JSON, CSV, Excel, or accessed via API. Each record includes a featureType field so mixed datasets are easy to route.

Business (search, details, category)

{
  "featureType": "business_details",
  "name": "Franklin Barbecue",
  "bizId": "franklin-barbecue-austin",
  "encBizId": "MGzro82Fi4LYvc86acoONQ",
  "url": "https://www.yelp.com/biz/franklin-barbecue-austin",
  "phone": "(512) 653-1187",
  "website": "https://franklinbbq.com",
  "email": "hello@franklinbbq.com",
  "rating": 4.5,
  "reviewCount": 6464,
  "priceRange": "$$",
  "categories": ["Barbeque"],
  "address": { "street": "900 E 11th St", "city": "Austin", "state": "TX", "zip": "78702", "country": "US" },
  "coordinates": { "latitude": 30.27, "longitude": -97.73 },
  "hours": [{ "day": "Tuesday", "open": "11:00", "close": "15:00" }],
  "amenities": ["Takes Reservations", "Outdoor Seating"],
  "socialLinks": { "instagram": "..." },
  "dataCompletenessScore": 70
}

Common business fields: name, bizId, encBizId, url, phone, phoneE164, website, email, emailSource, rating, reviewCount, priceRange, categories, primaryCategory, description, address, city, state, zip, country, coordinates, isClaimed, isClosed, imageUrl, dataCompletenessScore. Details adds hours, isOpenNow, amenities, paymentMethods, socialLinks, ratingDistribution, yearEstablished, photoUrls, menuUrl, menuItems, bookingUrl, and more.

Review

{
  "featureType": "business_reviews",
  "businessName": "Franklin Barbecue",
  "rating": 5,
  "text": "The OG. The start of it all… amazing.",
  "date": "2026-07-14T08:36:33-05:00",
  "author": { "name": "Sean H.", "reviewCount": 42, "location": "Austin, TX" },
  "photos": ["https://…/o.jpg"],
  "url": "https://www.yelp.com/biz/franklin-barbecue-austin?hrid=…"
}

Photo

{
  "featureType": "business_photos",
  "businessName": "Franklin Barbecue",
  "url": "https://…/o.jpg",
  "caption": "Brisket plate",
  "category": "food",
  "author": { "name": "Jay R." }
}

Event

{
  "featureType": "events",
  "title": "House Of Frog — Le Défilé",
  "date": "dimanche 20 sept. à 10:00 – 22:00",
  "venue": { "name": "L'Atelier Renault" },
  "category": "Autre",
  "url": "https://www.yelp.com/events/paris-house-of-frog-le-defile",
  "imageUrl": "https://…/o.jpg"
}

---

Real-time delivery (webhooks)

Every record is always saved to the dataset. Set webhookUrl to also receive each record the moment it is produced — no waiting for the run to finish.

• webhookFormat: "json" — the full record object is POSTed as JSON.
• webhookFormat: "slack" — a ready-to-post Slack message is sent (great for Slack Incoming Webhooks).

Works out of the box with Zapier, Make, n8n, Slack, Google Sheets, and any custom HTTP endpoint. Delivery is resilient — a slow or failing endpoint never stops your run or your dataset.

---

AI, LLM & MCP support

The output is designed to be agent-friendly: flat, predictable, well-named fields with no HTML or markup to clean up.

• Drop-in LLM context — feed records directly into prompts, RAG stores, or function-calling tools.
• MCP-compatible — run this actor through the Apify MCP server so assistants like Claude can call it as a tool and pull live Yelp data on demand.
• Deterministic schema — the featureType discriminator and stable field names make parsing and routing trivial in automated pipelines.

Example: an AI sales agent calls the actor with a niche + city, filters to filterMinRating: 4 and filterRequirePhone: true, and receives a clean list of qualified leads to act on.

---

Tips

• One feature per run. Enable exactly one feature; use scheduling or multiple runs for multiple jobs.
• Start small. Set a low searchMaxResultsPerQuery / reviewsMaxPerBusiness while testing, then scale up.
• Filter early. Use the filter fields to keep only the records you want — cleaner data and lower cost.
• Long runs are safe. Results stream to the dataset continuously, so memory stays flat even on large jobs.
• Schedule it. Use Apify Schedules to keep leads, reviews, or listings fresh automatically.

---

FAQ

Which locations are supported? Set locale for the target market. Business search, details, reviews, and photos work globally.

Can I get emails? Yes — enable includeEmailFromWebsite. Emails are discovered from the business's own website (they are not listed on Yelp profiles), so availability depends on the business.

Can I pass Yelp URLs I already have? Yes — use Business Details (businessUrls) or Scrape By URL (scrapeUrls).

How is data delivered? To the run dataset (JSON/CSV/Excel/API) and, optionally, to your webhookUrl in real time.

---

Contact & custom projects

Need something custom? I build scrapers and automation for any site and web apps of any kind — from one-off data pulls to full production systems and dashboards.

• 📧 Email: dubem115@gmail.com
• 💻 GitHub: github.com/DrunkCodes

Reach out for:

• Custom scraping projects (any website, any scale)
• Data pipelines, enrichment, and integrations (CRM, Sheets, webhooks, APIs)
• Web apps, dashboards, and internal tools
• Ongoing maintenance and scheduled data delivery

Let's build it — send a short description of what you need and I'll get back to you.