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
- 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" }
]
}{
"url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco",
"mode": "auto",
"extract": "auto"
}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.
| Field | What it holds | Example |
|---|---|---|
business. |
Business name | Tony's Pizza Napoletana |
business. |
Yelp's business ID, stable when the URL changes | mSMZJj2pFvttWLpcDmgrEA |
business. |
Star rating out of 5 | 4.2 |
business. |
Price level from $ to $$$$ |
$$ |
business. |
Public business phone number | (415) 835-9888 |
business. |
Link to the business website, through Yelp's redirect | /biz_redir?url=http%3A%2F%2Fwww.tonyspizzanapoletana.com… |
business. |
Whether the owner has claimed the page | true |
business. |
Health inspection result, where Yelp shows one | Pass |
business. |
The owner's description of the business | Tony's Pizza Napoletana is a state of the art full service restaurant… |
location. |
Street address, with city, state, postal_code and country next to it |
1570 Stockton St |
location., location. |
Coordinates | 37.800389, -122.409033 |
hours[] |
Opening hours per day | { "day": "Mon", "hours_range": "12:00 PM - 10:00 PM" } |
categories[]. |
Yelp categories | Pizza |
amenities[]. |
Services the business offers | Takes reservations |
vibe_ |
Atmosphere and audience tags | Good for groups |
photos[] |
Photo URL, thumbnail and caption | { "caption": "… Il Padrino Sicilian pizza …" } |
How to scrape Yelp with Zenrows
- Create a free Zenrows account and copy your API key from the dashboard.
- 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 ingolden-boy-pizza-san-francisco-5. - Send it with the default configuration: Adaptive Stealth Mode to open the page and Extract to return the fields.
- Read
parsedfrom the response. To keep only some fields, list them with their paths and the response returns just those. - 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"]])// Node 18+ (built-in fetch)
const params = new URLSearchParams({
apikey: "YOUR_ZENROWS_API_KEY",
url: "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco",
mode: "auto",
extract: "auto",
});
const response = await fetch(`https://api.zenrows.com/v1/?${params}`, {
signal: AbortSignal.timeout(180_000),
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const { parsed } = await response.json();
console.log(parsed.business.name, parsed.business.rating);
console.table(parsed.hours);curl "https://api.zenrows.com/v1/?apikey=YOUR_ZENROWS_API_KEY&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Ftonys-pizza-napoletana-san-francisco&mode=auto&extract=auto"
# Only the fields you need
curl "https://api.zenrows.com/v1/?apikey=YOUR_ZENROWS_API_KEY&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Ftonys-pizza-napoletana-san-francisco&mode=auto&extract=auto&extract_fields=business.name%2Cbusiness.rating%2Cbusiness.phone%2Clocation.street_address%2Chours"# pip install zenrows
from urllib.parse import parse_qs, urlparse
from zenrows import ZenRowsClient
client = ZenRowsClient("YOUR_ZENROWS_API_KEY")
response = client.get(
"https://www.yelp.com/biz/golden-boy-pizza-san-francisco",
params={"mode": "auto", "extract": "auto"},
)
biz = response.json()["parsed"]["business"]
redirect = biz.get("website_url") or ""
website = parse_qs(urlparse(redirect).query).get("url", [None])[0] # the real site behind Yelp's redirect
print(biz["name"], biz["rating"], website)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.
| Parameter | Type | Default | Description |
|---|---|---|---|
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_ |
string | all fields | Comma-separated paths to keep, such as business.name,business.rating,hours |
proxy_ |
string | any | Two-letter country code, to see the page as a visitor from that country, for example ca for yelp.ca |
wait_ |
string | none | A CSS selector to wait for before the page is read |
session_ |
integer | none | Keep the same session for up to 10 minutes across several pages of one business |
{
"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": {
"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"# businesses.jsonl: one {"url": "...", "external_id": "...", "extract": "auto"} per line
zenrows batch create businesses.jsonl --wait
zenrows batch results <job-id> --out yelp-businesses.jsonlcurl -X POST "https://api.zenrows.com/v1/crawls" \
-H "X-API-Key: YOUR_ZENROWS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.yelp.com/search?find_desc=pizza&find_loc=San+Francisco%2C+CA",
"depth": 1,
"max_pages": 100,
"include_patterns": ["/biz/"]
}'# Runs every day on Zenrows' side; each run keeps its own results
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": "scheduled",
"status": "closed",
"schedule": {
"rate": {
"every": 1,
"unit": "day"
}
},
"zenrows_params": {
"mode": "auto",
"extract": "auto"
},
"tasks": [
{
"url": "https://www.yelp.com/biz/tonys-pizza-napoletana-san-francisco",
"external_id": "yelp"
}
]
}'
# Or at set times: "schedule": { "calendar": { "times_of_day": ["09:00"],
# "cadence": { "weekly": { "days": ["mon", "thu"] } } }, "timezone": "Europe/Madrid" }What teams do with Yelp data
| Use case | Data they pull | Who 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,-5and so on when a name repeats in a city, sogolden-boy-pizza-san-franciscoandgolden-boy-pizza-san-francisco-5are two locations. Keep the exact URL per location. - Key rows on
yelp_id. Yelp can rename a business URL; the Yelp ID inbusiness.yelp_idstays the same. Use it as your primary key and as theexternal_idin Batch. - Decode the website link.
business.website_urlpoints to Yelp's redirect. The business's own site is theurlvalue 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+CAlists 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. Splithours_rangeon 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.
More Yelp and reviews & ratings scrapers
-
yelp.com
Yelp review scraper
Review text, star ratings, dates and reviewer locations for any Yelp business.
-
yelp.com
Yelp search scraper
Businesses matching a Yelp search and location, with rating, price level and category.
-
yelp.com
Yelp business scraper
Business page details: categories, hours, price range, amenities, rating and address.
-
trustpilot.com
Trustpilot scraper
Company TrustScores, star ratings, review counts and reviews from Trustpilot.
-
tripadvisor.com
Tripadvisor scraper
Hotels, restaurants and attractions with ratings, rankings, review counts and price ranges.
-
capterra.com
Capterra scraper
Software listings with user ratings, review counts, pricing and feature lists.
-
bbb.org
BBB scraper
Business profiles with BBB ratings, accreditation status, complaint counts and customer reviews.
-
imdb.com
IMDb scraper
Movies and shows with ratings, vote counts, cast, genres and runtimes.
-
g2.com
G2 scraper
Software product reviews with star ratings, pros and cons, categories and alternatives.
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'sparsedkey holds the business as a Python dictionary. Thezenrowspackage on PyPI wraps the same request. -
Yes. Each business page returns the public business phone number in
business.phoneand the full address inlocation, 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
parsedand the original page inhtml. You can also ask for the page as Markdown or plain text, which is what most LLM and RAG pipelines want.