Yelp Business Scraper

Scrape comprehensive business data from any Yelp business page. Profile, ratings, hours, attributes, photos, videos, menus, and reviews. Structured JSON output.

Paste a Yelp business URL, or search by keyword and location to discover businesses.

What you get

• Profile: name, alias, rating, review count, price range, phone, formatted address, coordinates
• Categories: full category details with ancestry and root categories
• Hours: weekly schedule with minute-level precision, special hours, currently open status
• Attributes: 20+ authoritative attributes (WiFi, parking, alcohol, noise level, etc.) with bool, single-choice, and multi-choice values
• Photos: photo tab counts by category (food, inside, outside, drink, menu), primary photo
• Videos: video carousel with Mux streaming URLs, durations, thumbnails, uploading users
• Menu: structured menu data (sections, items, descriptions, prices) when available
• Reviews: full text, ratings, author profiles, photos with dimensions, reactions, owner replies, expert recognition
• Owner: business owner profile with name, role, bio, photo
• Related: review snippets, review highlights, popular dishes, cost guides, partner data
• More: 40+ organized business properties, consumer alerts, data freshness, community questions

Quick start

Business profile data is always fetched. Reviews are opt-in via includeReviews toggle because they're charged per review.

Look up a single business:

{
  "businesses": ["https://www.yelp.com/biz/gary-danko-san-francisco"]
}

Search for businesses:

{
  "searchTerm": "pizza",
  "location": "San Francisco, CA",
  "maxSearchResults": 10
}

Everything:

{
  "businesses": ["gary-danko-san-francisco"],
  "includeReviews": true,
  "maxReviewsPerBusiness": 100
}

More examples

Multiple businesses:

{
  "businesses": [
    "gary-danko-san-francisco",
    "house-of-prime-rib-san-francisco"
  ]
}

Search with filters:

{
  "searchTerm": "dentist",
  "location": "10001",
  "category": "dentists",
  "maxSearchResults": 50,
  "searchSort": "rating",
  "searchRadius": 5000,
  "includeReviews": true,
  "maxReviewsPerBusiness": 10
}

Search by coordinates:

{
  "latitude": 37.7749,
  "longitude": -122.4194,
  "searchTerm": "coffee",
  "maxSearchResults": 5
}

Reviews with filters:

{
  "businesses": ["gary-danko-san-francisco"],
  "includeReviews": true,
  "sortBy": "RATING_DESC",
  "ratings": [1, 2],
  "maxReviewsPerBusiness": 100
}

With proxy (for full data including categories, claimed status):

{
  "searchTerm": "pizza",
  "location": "San Francisco, CA",
  "maxSearchResults": 5,
  "includeReviews": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input

Parameter	Type	Default	Description
businesses	string[]		Yelp business page URLs or aliases (e.g. gary-danko-san-francisco)
searchTerm	string		Search keyword (e.g. pizza, dentist). Alternative to businesses.
location	string		Location for search (city, zip, address, neighborhood)
latitude	number		GPS latitude for search. Must be used with longitude.
longitude	number		GPS longitude for search. Must be used with latitude.
category	string		Category alias filter for search (e.g. restaurants, dentists)
maxSearchResults	number	20	Max businesses to discover from search
searchSort	enum	default	default, distance, rating, review_count
searchRadius	number		Search radius in meters (e.g. 5000 = 5km)
includeReviews	boolean	false	Fetch and embed reviews inline. Charged per review.
maxReviewsPerBusiness	number	20	Max reviews per business. Set to 0 for no limit.
sortBy	enum	DATE_DESC	DATE_DESC, DATE_ASC, RATING_DESC, RATING_ASC, ELITES_DESC
ratings	number[]	[1,2,3,4,5]	Filter reviews by star rating
query	string	""	Search within reviews for keywords
languageCode	string	en	Review language filter (e.g. en, zh, de)
proxyConfiguration	object		Proxy settings. Residential proxies provide more complete data.

At least one of businesses or search params (searchTerm, location, or latitude+longitude) is required.

Output

One JSON object per business:

{
  "id": "WavvLdfdP6g8aZTtbBQHTw",
  "alias": "gary-danko-san-francisco",
  "name": "Gary Danko",
  "rating": 4.5,
  "reviewCount": 6120,
  "reviewCountsByRating": [137, 17, 9, 21, 101],
  "primaryPhotoUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/.../o.jpg",
  "coordinates": { "latitude": 37.8058, "longitude": -122.4206 },
  "categories": [
    { "alias": "newamerican", "title": "New American" },
    { "alias": "french", "title": "French" }
  ],
  "priceRange": "$$$$",
  "phoneNumber": "(415) 749-2060",
  "formattedPhone": "(415) 749-2060",
  "formattedAddress": {
    "addressLine1": "800 N Point St",
    "city": "San Francisco",
    "regionCode": "CA",
    "postalCode": "94109"
  },
  "location": {
    "address": { "addressLine1": "800 N Point St" },
    "neighborhoods": ["Russian Hill", "Fisherman's Wharf"],
    "timezone": "America/Los_Angeles"
  },
  "isCurrentlyOpen": true,
  "isClosedToday": false,
  "regularHoursRaw": [
    { "dayOfWeekShort": "Mon", "hours": ["5:00 PM - 10:00 PM"], "rawMinutes": [[1020, 1320]] }
  ],
  "authoritativeAttributes": [
    { "alias": "WiFi", "displayText": "Wi-Fi", "type": "single", "singleValue": { "alias": "free", "shortDisplayText": "Free" } },
    { "alias": "NoiseLevel", "displayText": "Noise Level", "type": "single", "singleValue": { "alias": "quiet", "shortDisplayText": "Quiet" } },
    { "alias": "Alcohol", "displayText": "Alcohol", "type": "single", "singleValue": { "alias": "full_bar", "shortDisplayText": "Full Bar" } },
    { "alias": "GoodForKids", "displayText": "Good for Kids", "type": "bool", "boolValue": false }
  ],
  "videoCarouselItems": [
    { "videoUrl": "https://stream.mux.com/.../high.mp4", "thumbnailUrl": "...", "durationMs": 15000 }
  ],
  "reviewSnippets": [
    { "id": "abc123", "text": "The tasting menu was extraordinary..." }
  ],
  "categoryAncestry": [
    { "alias": "newamerican", "title": "New American", "ancestry": [{ "alias": "restaurants", "title": "Restaurants" }] }
  ],
  "photoTabs": [
    { "label": "All", "alias": "all", "count": 14382 },
    { "label": "Food", "alias": "food", "count": 8000 }
  ],
  "menu": [
    {
      "sectionName": "Appetizers",
      "items": [
        { "name": "Glazed Oysters", "description": "Zucchini, leek fondue", "price": "22.00" }
      ]
    }
  ],
  "isClaimed": true,
  "isClosed": false,
  "yearEstablished": 1999,
  "specialties": "Contemporary fine dining...",
  "summary": "Known for its refined tasting menus...",
  "bizOwnerProfile": {
    "displayName": "Gary D.",
    "role": "Business Owner",
    "bio": "Chef and owner since 1999..."
  },
  "attributes": [
    { "name": "Takes Reservations", "alias": "RestaurantsReservations", "isActive": true },
    { "name": "Outdoor Seating", "alias": "OutdoorSeating", "isActive": true }
  ],
  "reviews": [
    {
      "id": "r1",
      "rating": 5,
      "text": "One of the best dining experiences...",
      "createdAt": "2026-03-15T00:00:00Z",
      "author": {
        "displayName": "Sarah M.",
        "displayLocation": "San Francisco, CA",
        "reviewCount": 42,
        "eliteYear": "2026",
        "isEliteAllStar": false
      },
      "feedback": { "usefulCount": 12, "funnyCount": 3, "coolCount": 8 },
      "photos": [
        { "url": "https://...", "caption": "Tasting menu", "width": 1000, "height": 750 }
      ],
      "ownerReply": "Thank you for the kind words!",
      "tags": { "checkInCount": 1, "isFirstReviewer": false }
    }
  ],
  "scrapedAt": "2026-04-17T10:00:00.000Z"
}

Fields truncated for readability. Actual output includes all sub-fields, all authoritative attribute values, full review author profiles, photo metadata (dimensions, keywords, likes, uploading user), video details, and 40+ additional business properties.

Limitations

• maxReviewsPerBusiness is per business, not total across all inputs
• Review search (query) forces relevance sort and may ignore rating filters
• Menu data is only available for businesses that have a Yelp menu page