Yelp Scraper 🍽️ — Business Listings, Ratings, Reviews, Hours, Photos & Contact Details

Yelp Scraper — Scrape Yelp business listings by search term and location. Each row carries name, rating, review count, price level, categories, phone, full address, geo, hours and photos, plus optional attributes, health score and reviews per business. It reads Yelp's own mobile API directly, so it's fast, reliable and complete — no login, no flaky HTML parsing, no headless browser. Export to JSON, CSV, Excel, or an API.

Search any US city, ZIP or neighborhood by keyword — get full business listings with ratings, reviews, price, hours, photos, phone and geo, straight from Yelp's own mobile API.

---

✨ Why use this Yelp Scraper?

• Human-friendly inputs — just a search term and a location string; no raw IDs or coordinates.
• Full field coverage per business: rating, review count, price, categories, address, geo, phone, hours, photos and more.
• Optional per-business enrichment: complete detail (attributes, hours, health score, owner) and reviews with summary.
• Talks to Yelp's own mobile API (not the bot-walled website), so results match the app.

---

🎯 What can you do with Yelp data?

• Build a local-business directory or lead list for a city or category.
• Monitor ratings, review counts and price levels of competitors.
• Enrich a CRM with verified phone numbers, addresses and opening hours.
• Analyze a market — categories, geo distribution and popularity by neighborhood.

---

📥 What data does the Yelp Scraper extract?

Each row includes: id, alias, name, url, rating, unrounded_rating, review_count, price_level, price, categories, phone, localized_phone, address, city …and more. See the full field list below.

---

🚀 How do I scrape Yelp.com? (3 steps)

1. Set your input — provide term or location (see the table below; defaults work out of the box).
2. Pick options — filters, a proxyConfiguration, and a maxItems cap.
3. Run & export — click Start, then download the dataset as JSON/CSV/Excel or fetch it via the API.

---

⚙️ What inputs does it take?

Field	Type	Default	Description
term	string	coffee	What to search for, e.g. 'coffee', 'plumbers', 'sushi'.
location	string	San Francisco, CA	City, neighborhood, address or ZIP — e.g. 'San Francisco, CA'. Yelp resolves it server-side.
includeDetails	boolean	false	Fetch the full business page (all attributes, hours, health score, owner info) for each result.
includeReviews	boolean	false	Fetch reviews and the per-language review-count summary for each result.
maxItems	integer	40	Maximum number of businesses to return (0 = as many as the API paginates).
proxyConfiguration	object	Apify Proxy	Route requests through a proxy (Apify Proxy by default).

Example input

{
  "term": "coffee",
  "location": "San Francisco, CA",
  "includeDetails": false,
  "includeReviews": false,
  "maxItems": 40,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}

---

📤 What does a result row look like?

Each result is a JSON object like this:

{
  "id": "24ym9XJUS2i9JlSFEJeZ2w",
  "alias": "the-coffee-movement-san-francisco",
  "name": "The Coffee Movement",
  "url": "https://www.yelp.com/biz/the-coffee-movement-san-francisco",
  "rating": 4.5,
  "unrounded_rating": 4.6,
  "review_count": 750,
  "price_level": "$$",
  "price": 2,
  "categories": [
    {
      "name": "Coffee & Tea",
      "alias": "coffee",
      "is_restaurant": false
    }
  ],
  "phone": "4152373375",
  "localized_phone": "(415) 237-3375",
  "address": "1030 Washington St",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94108",
  "country": "US",
  "neighborhoods": [
    "Nob Hill"
  ],
  "latitude": 37.794825,
  "longitude": -122.4103212,
  "timezone": "America/Los_Angeles",
  "is_closed": false,
  "photo_count": 1885,
  "photos": [
    {
      "id": "7xnjaGpC1Gn8eXC7lvPU3w",
      "url": "https://s3-media0.fl.yelpcdn.com/bphoto/7xnjaGpC1Gn8eXC7lvPU3w/l.jpg",
      "url_original": "https://s3-media0.fl.yelpcdn.com/bphoto/7xnjaGpC1Gn8eXC7lvPU3w/o.jpg",
      "caption": "Cortado (~$4)",
      "width": 2800,
      "height": 3733,
      "type": "business"
    },
    {
      "id": "phipK7re5PrtBOZXi5jEHw",
      "url": "https://s3-media0.fl.yelpcdn.com/bphoto/phipK7re5PrtBOZXi5jEHw/l.jpg",
      "url_original": "https://s3-media0.fl.yelpcdn.com/bphoto/phipK7re5PrtBOZXi5jEHw/o.jpg",
      "caption": "Iced Vanilla Rosemary Latte (~$6)",
      "width": 4284,
      "height": 5712,
      "type": "business"
    },
    "…+1 more"
  ],
  "primary_photo": "https://s3-media0.fl.yelpcdn.com/bphoto/7xnjaGpC1Gn8eXC7lvPU3w/o.jpg",
  "hours": [
    "Mon-Fri 7:00 am - 2:00 pm",
    "Sat-Sun 7:00 am - 4:00 pm"
  ],
  "attributes": [
    {
      "id": "RestaurantsDelivery",
      "label": "Offers Delivery",
      "value": "No"
    },
    {
      "id": "RestaurantsTakeOut",
      "label": "Offers Takeout",
      "value": "Yes"
    },
    "…+14 more"
  ],
  "health_score": "Pass",
  "menu_url": "https://www.thecoffeemovement.com/menu",
  "website_url": "http://thecoffeemovement.com",
  "reviews": [
    {
      "id": "DioPsvaDWXqGt4Xac01O_Q",
      "rating": 5,
      "text": "Coffee Movement is a spot for folks who truly appreciate the simplicity of a great espresso.\n\nI've been to Coffee Movement a couple of times and have thoroug…",
      "language": "en",
      "time_created": null,
      "time_modified": 1781837480,
      "feedback": {
        "…": "3 fields"
      },
      "user": null
    },
    {
      "id": "wMbh9da-2wW40vqejvkRsw",
      "rating": 4,
      "text": "The Coffee Movement is a small specialty coffee shop that focuses on doing a few things extremely well. We walked into a minimalist, compact space with limit…",
      "language": "en",
      "time_created": null,
      "time_modified": 1781993163,
      "feedback": {
        "…": "3 fields"
      },
      "user": null
    },
    "…+8 more"
  ],
  "review_summary": {
    "language_review_counts": {
      "en": 747,
      "zh": 2,
      "de": 1
    },
    "not_recommended_review_count": 46
  }
}

Fields marked (detail) — attributes, health_score, health_score_detail, from_this_business, menu_url, website_url, share_url — are only populated when Include full business detail is on. reviews and review_summary come from Include reviews, which is a separate option.

---

🧾 Which fields does each row contain?

Field	Type	Description
id	text	Business ID
alias	text	Alias
name	text	Name
url	link	Yelp URL
rating	number	Rating
unrounded_rating	number	Unrounded rating
review_count	number	Review count
price_level	text	Price level
price	number	Price (1-4)
categories	array	Categories
phone	text	Phone, digits only
localized_phone	text	Phone formatted for the country
dialable_phone	text	Phone as a dialable string
address	text	Street address (line 1)
address2	text	Street address (line 2)
localized_address	text	Full address as Yelp renders it
cross_streets	text	Cross streets
city	text	City
state	text	State
zip	text	ZIP
country	text	Country
neighborhoods	array	Neighborhoods
latitude	number	Latitude
longitude	number	Longitude
timezone	text	Timezone
is_closed	boolean	Permanently closed
is_temp_closed	boolean	Temporarily closed
is_chain	boolean	Part of a chain
is_yelp_guaranteed	boolean	Covered by Yelp Guaranteed
photo_count	number	Photo count
video_count	number	Video count
photos	array	Photos (id, url, url_original, caption, width, height, type)
primary_photo	link	Primary photo
hours	array	Hours as display strings
hours_raw	array	Hours as Yelp's structured objects
attributes	array	Attributes (detail)
health_score	text	Health score (detail)
health_score_detail	object	Health score with inspection metadata (detail)
from_this_business	object	"From this business" owner content (detail)
menu_url	text	Menu URL (detail, when Yelp has one)
website_url	link	Business website (detail, when Yelp has one)
share_url	link	Yelp share URL (detail, when Yelp has one)
reviews	array	Reviews (reviews)
review_summary	object	Review counts per language + not-recommended count (reviews)

---

📖 What do the Yelp-specific fields mean?

• alias — the slug Yelp uses in its own URLs, e.g. the-coffee-movement-san-francisco; url is built from it.
• price / price_level — price is Yelp's 1-4 price band as a number; price_level is the same band as Yelp displays it ($, $$, $$$, $$$$).
• rating / unrounded_rating — rating is the star rating rounded to the nearest half star (what the app shows); unrounded_rating is the raw average behind it.
• health_score — the health-inspection result Yelp publishes for the business (e.g. Pass), only where the local health authority feeds Yelp that data.
• not_recommended_review_count (in review_summary) — how many reviews Yelp's filter treats as not recommended; those reviews are not returned in reviews.
• is_yelp_guaranteed — the flag Yelp sets when the business takes part in Yelp Guaranteed.

---

💰 How much does it cost?

This actor uses pay-per-event pricing: you pay only for the rows it actually delivers, layered by what you enable.

Event	When it's charged	Price
Business result	Per business returned from search (basic data — name, rating, address, categories, photos, etc.)	$1.00 per 1,000 rows
Business details	Per business, only when includeDetails is on and full detail was fetched	+$1.00 per 1,000 rows
Business reviews	Per business, only when includeReviews is on and its reviews were fetched — billed per company, not per review	+$1.00 per 1,000 rows

Enabling includeDetails and includeReviews together costs $3.00 per 1,000 businesses. Leave both off and you pay only the base $1.00 per 1,000. You're never charged for an enrichment call that failed to return data.

---

🔌 How do I run it from my own code?

Run it programmatically with the Apify API:

curl -X POST "https://api.apify.com/v2/acts/yelp-api-scraper/runs?token=YOUR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "term": "coffee",
  "location": "San Francisco, CA",
  "includeDetails": false,
  "includeReviews": false,
  "maxItems": 40,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}'

Or with the Apify CLI: apify call yelp-api-scraper -i input.json -o.

---

❓ FAQ

Do I need a Yelp account or API key?

No. The scraper uses guest access to Yelp's mobile API — no login, no Fusion API key, no quota.

What do I type for the location?

Anything a person would: a city ('San Francisco, CA'), a ZIP code, a neighborhood or an address. Yelp resolves it server-side.

Which countries does this work in?

Only countries Yelp itself operates in — Yelp has no listings outside these, so any other location fails with "Bad location":

United States, Canada, Austria, Belgium, Chile, Czech Republic, Denmark, France, Germany, Greece, Iceland, Indonesia, Ireland, Italy, Malaysia, Mexico, Netherlands, New Zealand, Norway, Philippines, Poland, Singapore, South Africa, Spain, Sweden, Switzerland, Turkey, United Kingdom.

Coverage is patchy and thin outside the US/Canada — expect the most complete results there.

Why is a proxy recommended?

Yelp's edge blocks datacenter IPs. Use Apify Proxy (default) or supply your own residential/ISP proxy so requests come from a clean IP.

Can I get full reviews and hours?

Yes — enable 'Include full business detail' and 'Include reviews' to fetch complete hours, attributes, health score, owner info and reviews per business.

Can I run it on a schedule?

Yes. Add the actor to an Apify schedule (hourly, daily, weekly) and each run re-scrapes the same term and location, so you can track ratings and review counts over time. Every run is billed by the rows it delivers.

How do I keep the cost bounded?

Set maxItems — it stops the run at that many businesses (default 40). Leave it at 0 only if you want every page Yelp will serve. Enrichment is opt-in per option, so a search-only run stays at the base per-row price.

What happens if a business's detail or review fetch fails?

The row is still pushed with everything the search card gave, a warning naming the business appears in the log, and no enrichment event is charged for it — you only pay for enrichment that actually returned data. If a later page of search results keeps failing, the run stops paginating and keeps the rows already collected instead of failing.

---

🛠️ How does it work?

The actor impersonates Yelp's official app/site and calls its private API the same way the app does, then normalises each response into the flat record above. No browser, no HTML scraping — just clean, structured data.

---

📌 Good to know

• Scrape only public local business listing data and respect Yelp.com's Terms of Service and robots policy.
• For personal data, comply with GDPR/CCPA and applicable law — you are the data controller.
• Fields can be null when Yelp doesn't expose them for a given record.
• Input is a search term plus a location — there is no "scrape this one Yelp URL" mode. Search for the business by name and its city to get its row.

---

⭐ Found this useful?

Give the Yelp Scraper a star on Apify and check out my other apify-*-api-scraper actors.