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, alias, or encrypted business ID, 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: full-size and thumbnail URLs, captions, dimensions, uploader profiles, like counts, associated review with full text and author stats
• Videos: Mux streaming URLs (high/medium/low), thumbnails, durations, captions, uploader profiles, like counts, associated reviews
• 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
}

Look up by encrypted business ID (skips HTML page fetch):

{
  "businesses": ["WavvLdfdP6g8aZTtbBQHTw"]
}

Everything:

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

More examples

Multiple businesses (URLs, aliases, and IDs can be mixed):

{
  "businesses": [
    "WavvLdfdP6g8aZTtbBQHTw",
    "https://www.yelp.com/biz/house-of-prime-rib-san-francisco"
  ]
}

Search with filters:

{
  "searchTerm": "dentist",
  "location": "10001",
  "category": "dentists",
  "maxSearchResults": 50,
  "searchSort": "rating",
  "searchRadius": 5,
  "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, aliases (e.g. gary-danko-san-francisco), or encrypted business IDs (e.g. WavvLdfdP6g8aZTtbBQHTw). IDs are auto-detected (22-char base64url) and skip the HTML page fetch.
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. Unit set by searchRadiusUnit (default: km). Max ~40 km / 25 mi.
searchRadiusUnit	enum	km	Unit for searchRadius: km or miles
includePhotos	boolean	false	Fetch business photos with metadata. Charged per photo.
maxPhotosPerBusiness	number	20	Max photos per business. Set to 0 for no limit.
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 }
  ],
  "businessPhotos": [
    {
      "id": "5dbjkeTld05HumeToIAhRQ",
      "url": "https://s3-media0.fl.yelpcdn.com/bphoto/.../o.jpg",
      "thumbnailUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/.../348s.jpg",
      "caption": "Matcha cake",
      "width": 2000,
      "height": 1500,
      "uploadedAt": "2022-10-16T01:35:42Z",
      "uploadingUser": {
        "id": "8uPPJIL...",
        "displayName": "Rie K.",
        "profilePhotoUrl": "https://s3-media0.fl.yelpcdn.com/photo/.../ss.jpg"
      },
      "keywords": [],
      "likeCount": 7,
      "review": {
        "id": "VpkPhqRR...",
        "rating": 4,
        "text": "This was another special place...",
        "createdAt": "2022-10-31T04:27:27Z",
        "author": {
          "id": "8uPPJIL...",
          "displayName": "Rie K.",
          "reviewCount": 105,
          "friendCount": 243,
          "photoCount": 1136
        }
      }
    }
  ],
  "businessVideos": [
    {
      "id": "LIeg3ZcXuc850oP3Kxc8mg",
      "videoUrl": "https://stream.mux.com/.../high.mp4",
      "thumbnailUrl": "https://image.mux.com/.../thumbnail.jpg?height=720&time=0",
      "caption": "Baked Alaska!",
      "durationMs": 7566,
      "createdAt": "2026-03-01T18:31:27Z",
      "uploadingUser": { "id": "k72mlJ...", "displayName": "Harold R.", "profilePhotoUrl": "https://..." },
      "renditions": [
        { "quality": "high", "url": "https://stream.mux.com/.../high.mp4", "durationMs": 7566 },
        { "quality": "medium", "url": "https://stream.mux.com/.../medium.mp4", "durationMs": 7566 },
        { "quality": "low", "url": "https://stream.mux.com/.../low.mp4", "durationMs": 7566 }
      ],
      "likeCount": 0,
      "review": { "id": "02ADzS...", "rating": 5, "text": "First time ever to Gary Danko...", "createdAt": "2026-03-01T18:31:27Z", "author": { "id": "k72mlJ...", "displayName": "Harold R.", "reviewCount": 303, "friendCount": 1, "photoCount": 93 } }
    }
  ],
  "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
• ID lookups skip the HTML page and menu fetch, so Apollo cache data (e.g. isClaimed, specialties, yearEstablished) and menu data will be null