README.md

Yelp Business Scraper - Reviews, Ratings, Hours & Contact Info

Scrape Yelp business details: name, rating, reviews, price range, categories, address, phone, website, hours, and coordinates.

What you get

Extract comprehensive business data from Yelp. Search any business type in any US location. Get ratings, review counts, price range, categories, full address, phone, website, hours of operation, and GPS coordinates.

Output fields

Field	Description
name	Business name
rating	Yelp rating (1-5)
review_count	Number of reviews
price_range	Price level ($, $$, $$$, $$$$)
categories	Business categories
address	Full address
city	City
state	State
zip_code	ZIP code
phone	Phone number
website	Business website
hours	Operating hours
latitude	GPS latitude
longitude	GPS longitude
url	Yelp business page URL

Example output

{
    "name": "Joe's Pizza",
    "rating": 4.5,
    "review_count": 2300,
    "price_range": "$",
    "categories": ["Pizza", "Italian"],
    "address": "7 Carmine St",
    "city": "New York",
    "state": "NY",
    "zip_code": "10014",
    "phone": "(212) 366-1182",
    "website": "https://joespizzanyc.com",
    "hours": {"Mon": "10:00 AM - 4:00 AM", "Tue": "10:00 AM - 4:00 AM"},
    "latitude": 40.7303,
    "longitude": -74.0023,
    "url": "https://www.yelp.com/biz/joes-pizza-new-york"
}

Input parameters

Parameter	Required	Description
searchQuery	Yes	Business type and location (e.g., "pizza new york", "dentist chicago")
maxResults	No	Max businesses to extract (default: 20)

Use cases

• Lead generation: Find local businesses with contact info for outreach
• Market research: Analyze business ratings and review volumes by area
• Competitor analysis: Compare ratings and review counts across competitors
• Local SEO: Audit business listings and track review trends
• Data enrichment: Add Yelp ratings and contact info to business databases

Pricing

Pay-per-result pricing at $0.005 per business listing. Volume discounts available.

Limitations

• Primarily US-focused (Yelp's strongest market)
• Some businesses may have limited data (hours, website)
• Review text extraction is not included (only counts and ratings)