Crawl: the most reliable web crawler APISee what’s new
Zenrows
Talk to sales Start free

Yelp scraper

The Zenrows Yelp scraper turns any Yelp business URL into structured JSON: business name, Yelp ID, rating, price range, phone, website, street address, coordinates, opening hours, categories, amenities, vibe attributes and photos with captions. You send the URL, Fetch in Adaptive Stealth Mode opens the page, and Extract returns the fields. Run it from an API call, the CLI or an AI agent.

Site
yelp.com
Returns
Local businesses, ratings, hours, categories and photos
Runs on
Fetch, Extract, Batch, Crawl
Updated
{
  "business": {
    "name": "Tony's Pizza Napoletana",
    "yelp_id": "mSMZJj2pFvttWLpcDmgrEA",
    "rating": 4.2,
    "price_range": "$$",
    "phone": "(415) 835-9888",
    "is_claimed": true,
    "health_score": "Pass",
    "yelp_url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco"
  },
  "categories": [
    { "name": "Pizza" },
    { "name": "Italian" },
    { "name": "Cocktail Bars" }
  ],
  "location": {
    "street_address": "1570 Stockton St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94133",
    "country": "US",
    "latitude": 37.800389,
    "longitude": -122.409033
  },
  "hours": [
    { "day": "Mon", "hours_range": "12:00 PM - 10:00 PM" },
    { "day": "Fri", "hours_range": "12:00 PM - 11:00 PM" }
  ]
}

Request and output of a live call to a Yelp business page on Oct 20, 2026, trimmed for length. A field is returned when the page shows it.

What data can you scrape from Yelp?

A Yelp business page comes back as the business, its location, hours, categories, amenities, vibe and photos.

These are the fields teams use most, with the path where each lives in the JSON.

FieldWhat it holdsExample
business.name Business name Tony's Pizza Napoletana
business.yelp_id Yelp's business ID, stable when the URL changes mSMZJj2pFvttWLpcDmgrEA
business.rating Star rating out of 5 4.2
business.price_range Price level from $ to $$$$ $$
business.phone Public business phone number (415) 835-9888
business.website_url Link to the business website, through Yelp's redirect /biz_redir?url=http%3A%2F%2Fwww.tonyspizzanapoletana.com…
business.is_claimed Whether the owner has claimed the page true
business.health_score Health inspection result, where Yelp shows one Pass
business.specialties_description The owner's description of the business Tony's Pizza Napoletana is a state of the art full service restaurant…
location.street_address Street address, with city, state, postal_code and country next to it 1570 Stockton St
location.latitude, location.longitude Coordinates 37.800389, -122.409033
hours[] Opening hours per day { "day": "Mon", "hours_range": "12:00 PM - 10:00 PM" }
categories[].name Yelp categories Pizza
amenities[].label Services the business offers Takes reservations
vibe_attributes[].label Atmosphere and audience tags Good for groups
photos[] Photo URL, thumbnail and caption { "caption": "… Il Padrino Sicilian pizza …" }

How to scrape Yelp with Zenrows

  1. Create a free Zenrows account and copy your API key from the dashboard.
  2. Pick the business URL. Yelp business pages follow https://www.yelp.com/biz/<name>-<city>, with a number at the end when a name repeats in a city, as in golden-boy-pizza-san-francisco-5.
  3. Send it with the default configuration: Adaptive Stealth Mode to open the page and Extract to return the fields.
  4. Read parsed from the response. To keep only some fields, list them with their paths and the response returns just those.
  5. Send your list of businesses to Batch once one URL returns what you need.
# pip install requests
import requests

params = {
    "apikey": "YOUR_ZENROWS_API_KEY",
    "url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco",
    "mode": "auto",          # Adaptive Stealth Mode
    "extract": "auto",       # structured JSON
}
response = requests.get("https://api.zenrows.com/v1/", params=params, timeout=180)
response.raise_for_status()

data = response.json()["parsed"]
biz, loc = data["business"], data["location"]
print(biz["name"], biz["rating"], biz["price_range"], biz["phone"])
print(loc["street_address"], loc["city"], loc["state"], loc["postal_code"])
print([c["name"] for c in data["categories"]])

Input

The scraper takes one Yelp URL per request, plus the options below.

A Batch job applies the same parameters to every task, so the input for a thousand businesses is a list of URLs with these settings.

ParameterTypeDefaultDescription
url string required A Yelp business page (/biz/<name>-<city>), on yelp.com or a Yelp country site
mode string auto Adaptive Stealth Mode: starts with the lightest setup and adds rendering and protected-site handling only when Yelp needs them
extract string auto Returns the page's fields as JSON in parsed, next to the raw html
extract_fields string all fields Comma-separated paths to keep, such as business.name,business.rating,hours
proxy_country string any Two-letter country code, to see the page as a visitor from that country, for example ca for yelp.ca
wait_for string none A CSS selector to wait for before the page is read
session_id integer none Keep the same session for up to 10 minutes across several pages of one business
Batch input
{
  "type": "regular",
  "status": "closed",
  "zenrows_params": {
    "mode": "auto",
    "extract": "auto"
  },
  "tasks": [
    { "url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco", "external_id": "mSMZJj2pFvttWLpcDmgrEA" },
    { "url": "https://www.yelp.com/biz/golden-boy-pizza-san-francisco", "external_id": "golden-boy-north-beach" },
    { "url": "https://www.yelp.com/biz/golden-boy-pizza-san-francisco-5", "external_id": "golden-boy-parkside" }
  ]
}

Output

Every response is JSON with two keys: html, the page as Yelp served it, and parsed, the structured record. A business page returns the groups below. The sample keeps more of the same live response, including the owner's description, amenities, vibe and photos.

Need a spreadsheet? Flatten business and location into one row per business with pd.json_normalize(...) and write CSV or Excel. Need the page for an LLM? Ask for Markdown instead of JSON.

Business page
{
  "business": {
    "name": "Tony's Pizza Napoletana",
    "yelp_id": "mSMZJj2pFvttWLpcDmgrEA",
    "rating": 4.2,
    "price_range": "$$",
    "phone": "(415) 835-9888",
    "is_claimed": true,
    "health_score": "Pass",
    "photo_count": 10,
    "logo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/ptCPOJoqVokZW7GmQ5F4NQ/l.jpg",
    "website_url": "/biz_redir?url=http%3A%2F%2Fwww.tonyspizzanapoletana.com&cachebuster=1792462315&website_link_type=website…",
    "specialties_description": "Tony's Pizza Napoletana is a state of the art full service restaurant that offers several styles of pizzas which include Neapolitan, Classic American and Italian, Sicilian, Pizza Romana, Gluten Free and New York, Detroit and St. Louis Style and displays seven different types of pizza ovens…",
    "yelp_url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco"
  },
  "categories": [
    { "name": "Pizza" },
    { "name": "Italian" },
    { "name": "Cocktail Bars" }
  ],
  "location": {
    "street_address": "1570 Stockton St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94133",
    "country": "US",
    "neighborhood": null,
    "latitude": 37.800389,
    "longitude": -122.409033
  },
  "hours": [
    { "day": "Mon", "hours_range": "12:00 PM - 10:00 PM" },
    { "day": "Tue", "hours_range": "12:00 PM - 10:00 PM" },
    { "day": "Sat", "hours_range": "12:00 PM - 11:00 PM" },
    { "day": "Sun", "hours_range": "12:00 PM - 11:00 PM" }
  ],
  "amenities": [
    { "label": "Takes reservations" },
    { "label": "Offers delivery" },
    { "label": "Offers take-out" }
  ],
  "vibe_attributes": [
    { "label": "Casual" },
    { "label": "Outdoor seating" },
    { "label": "Good for groups" }
  ],
  "photos": [
    {
      "caption": "Tony's Pizza Napoletana - Il Padrino Sicilian pizza - San Francisco, CA",
      "thumbnail_url": "https://s3-media0.fl.yelpcdn.com/bphoto/zEg9dnZ8yfhXrGtsNnpteg",
      "url": "https://s3-media0.fl.yelpcdn.com/bphoto/zEg9dnZ8yfhXrGtsNnpteg/l.jpg"
    }
  ]
}

Connect the MCP server (Claude Code)

claude mcp add zenrows -e ZENROWS_API_KEY=YOUR_ZENROWS_API_KEY -- npx -y @zenrows/mcp

MCP config (Cursor, Claude Desktop, Windsurf)

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": { "ZENROWS_API_KEY": "YOUR_ZENROWS_API_KEY" }
    }
  }
}

Or run the CLI

npx -y @zenrows/cli init
zenrows extract "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco"

Then ask your agent

Use Zenrows to scrape these Yelp pages and return a table with name,
rating, price range, phone, address, categories and Sunday hours:
https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco
https://www.yelp.com/biz/golden-boy-pizza-san-francisco

Scrape Yelp from your coding agent

Claude Code, Cursor, Codex and any MCP client can scrape Yelp from a prompt.

The agent sends the same Fetch and Extract request a developer would, so it reads the business record above and can compare places for you. Connect the Zenrows MCP server once, or install the CLI and let the agent run it in the terminal.

Scrape Yelp at scale with Batch and Crawl

Batch runs a list of Yelp business URLs as one job, in parallel, with your own ID on each result. Use the Yelp ID or your own location code as the ID, and rerun the job monthly to catch changes in ratings, hours and categories across a market.

Crawl follows links from a Yelp page and returns every page it reaches. Start it on a Yelp search for a category and city, keep the links that contain /biz/, and it collects the business pages in those results. Send that list to Batch with Extract.

Scheduled jobs run the same Batch job on a timetable, on Zenrows' side: every few hours, once a day, at set times on chosen days, or once at a future date. Each run keeps its own results, a webhook can tell your app when a run finishes, and you can pause or resume the schedule at any time, with no cron server to keep alive.

curl -X POST "https://async.api.zenrows.com/v1/jobs" \
  -H "X-API-Key: YOUR_ZENROWS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "regular",
    "status": "closed",
    "zenrows_params": { "mode": "auto", "extract": "auto" },
    "tasks": [
      { "url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco", "external_id": "mSMZJj2pFvttWLpcDmgrEA" },
      { "url": "https://www.yelp.com/biz/golden-boy-pizza-san-francisco", "external_id": "golden-boy-north-beach" }
    ]
  }'

# Read the results when the job finishes
curl "https://async.api.zenrows.com/v1/jobs/JOB_ID/results?status=successful" \
  -H "X-API-Key: YOUR_ZENROWS_API_KEY"

What teams do with Yelp data

Use caseData they pullWho runs it
Local lead lists Name, category, phone, website, address and claimed status per business Sales teams selling to restaurants and local services
Market mapping Businesses per category and neighborhood, with coordinates and price level Franchise, real estate and expansion teams
Competitor benchmarking Rating, price range, hours and amenities of nearby competitors Restaurant groups and multi-location brands
Listing accuracy audits Hours, phone, address and categories against your own location data Local SEO agencies and brand teams
Food and hospitality research Categories, vibe attributes, delivery and reservation options by city Analysts, investors and food service suppliers
AI local search assistants The full business record, or the page as Markdown AI and product teams

Tips for scraping Yelp

  • Watch the number at the end of the URL. Yelp adds -2, -5 and so on when a name repeats in a city, so golden-boy-pizza-san-francisco and golden-boy-pizza-san-francisco-5 are two locations. Keep the exact URL per location.
  • Key rows on yelp_id. Yelp can rename a business URL; the Yelp ID in business.yelp_id stays the same. Use it as your primary key and as the external_id in Batch.
  • Decode the website link. business.website_url points to Yelp's redirect. The business's own site is the url value in that link's query string, as in the Python SDK example.
  • Collect URLs from search pages. A Yelp search such as /search?find_desc=pizza&find_loc=San+Francisco%2C+CA lists the businesses of a category and city. Crawl it, or page it with &start=10, to build your list of /biz/ URLs.
  • Normalize hours per day. hours[] gives one entry per day with a text range. Split hours_range on the dash to get opening and closing times for open-now checks.
  • Use the country sites for other markets. yelp.ca, yelp.co.uk and yelp.com.au list businesses in those countries with the same page layout. Set the matching country.

Frequently asked questions

  • Collecting public business information from Yelp, such as names, categories, ratings, hours and business phone numbers shown to every visitor, is common practice for market research and local lead lists. Reviews and photos can include personal data about reviewers, which laws such as the GDPR and the CCPA protect, so collect only what you have a legitimate reason to use. Check Yelp's terms for your use case and ask your lawyer if you are unsure.

  • Yes. The Yelp Places API, formerly Yelp Fusion, returns business search results and business details with an API key, and up to three review excerpts per business. Its terms cover how the data is displayed and stored, and commercial use runs on paid plans after a trial. Teams that need the full business page, with every amenity, vibe tag and photo caption, use a scraper.

  • Business pages at yelp.com/biz/<name>-<city> on yelp.com and the Yelp country sites. Search pages work as start points for Crawl to find business URLs.

  • Send a GET request to https://api.zenrows.com/v1/ with your API key, the Yelp business URL, Adaptive Stealth Mode and Extract turned on, as in the Python example above. The response's parsed key holds the business as a Python dictionary. The zenrows package on PyPI wraps the same request.

  • Yes. Each business page returns the public business phone number in business.phone and the full address in location, with street, city, state, postal code, country and coordinates. These are business details the owner publishes, not personal contact data.

  • Send one URL per request, or a whole list as a Batch job that runs the URLs in parallel and keeps your own ID on each result. One Batch job accepts more than 10,000 URLs, sent inline or as a CSV file.

  • Yes. Connect the Zenrows MCP server to Claude, Cursor, Codex or any MCP client, or give your agent the Zenrows CLI. Ask for the businesses you want in plain language and the agent calls Fetch and Extract for you.

  • Yes. Create a scheduled Batch job with your Yelp URLs and the same settings as a single request, and Zenrows runs it on its side: every few hours, once a day, at set times on chosen days, or once at a future date. Each run keeps its own results, a webhook can notify your app when a run finishes, and the schedule can be paused or resumed at any time.

  • Zenrows works with n8n, Make, Zapier, Clay, Dify, LangChain, LlamaIndex, CrewAI and Mastra, plus the Python, Node.js and Go SDKs and any HTTP client. Send businesses to a CRM, Clay table or Google Sheet from the workflow tool you already use. See the integrations page for the full list. For hotels and restaurants with traveler reviews, see the Tripadvisor scraper.

  • JSON by default, with the structured record in parsed and the original page in html. You can also ask for the page as Markdown or plain text, which is what most LLM and RAG pipelines want.

Turn the live web into usable data.

Start building free 5,000 credits/month, always