Actor picture

Yelp Scraper


Scrape Yelp data as business details, reviews, and ratings without API.

Author's avatarMatej Gagyi
  • Modified
  • Used by194 users
  • Used1,502 times

Yelp Scraper

Yelp scraper is an Apify actor able to extract reviews and ratings from Yelp business pages. The scraper is capable of performing Yelp searches, either by querying Yelp with an optional location or by scraping direct URLs pointing to searches. Also, the scraper recognizes Yelp business pages and scrapes reviews from direct business URLs.

The scraper uses Apify SDK and can be run locally or using Apify cloud platform.


When using the scraper on the Apify platform or locally, there are multiple configurable input variables available:

Field Type Required Default Description
searchTerm string see below Used for searching particular item, service, or business.
location string No Location to search.
searchLimit number No 10 Number of search results to crawl from each search results page specified.
directUrls array see below [] Predefined collection of string URLs to scrape review. Can be search URLs or business pages, other URLs will be ignored.
reviewLimit number No 20 Minimum number of reviews to scrape.
proxy proxy configuration Yes { useApifyProxy: true } Proxy groups and other proxy related configuration.
maxRequestRetries number No 10 How many times a failed request is retried before thrown away. Requests usually failed when blocked by the target site.

One of searchTerm or directUrls is required. If none are specified, nothing will be scrapped.


You'll get your review in the following schema:

  "directUrl": "<business url>",
  "bizId": "<business id>",
  "name": "<business id>",
  "description": "<business description>",
  "categories": ["<business categories>"],
  "type": "<business type>",
  "phone": "<business phone>",
  "reviewCount": "<business reviewCount>",
  "aggregatedRating": "<business rating>",
  "priceRange": "<business price range>",
  "cuisine": "<business cuisine>",
  "website": "<business website>",
  "images" : ["<bussiness image URL>"],
  "address": {
    "addressLocality": "<business locality>",
    "addressRegion": "<business city>",
    "streetAddress": "<business address>",
    "postalCode": "<business postal>",
    "addressCountry": "<business country>"
  "reviews": [
      "date": "<review date>",
      "rating": "<rating>",
      "text": "<review text>",
      "photos": [


If you want to run the actor on the Apify platform, you need to open the actor's page in the Store and then click on Try for free. That will create a task (actor configuration) on your account. When using public actors, you don't need to build them since the author already did everything. You only need to provide input, and then you can run them. But keep in mind that resource usage will always be charged towards the account which runs the actor. You can also use webhooks to let it run automatically after any actor or task.

If you want to run the actor locally, you need to open the actor's github page and clone it to your computer.

Advanced data access

You might want to access the scraped reviews in a flat format. Apify API provides a simple way to do just that. When accessing your dataset through the API, you can tell the API server to provide one review per dataset entry using the unwind GET parameter:<DatasetId>/items?unwind=reviews

This functionality is documented in the Apify API documentation under Datasets -> Item collection -> Get items.


Feel free to fork me, and don't forget to submit your Pull Request!