Yelp Business Scraper - Business Details from Links

Turn a list of Yelp business links into clean business rows. Paste links from any Yelp site (yelp.com, yelp.ca, yelp.co.uk, yelp.com.au, yelp.de, m.yelp.com and the rest), the alias at the end of a link, or Yelp business ids. Every business becomes one row with its name, star rating, review count, categories, price range, full address, phone number, opening hours, website, map coordinates, photo count, amenities and whether it is closed or claimed. No Yelp account is needed.

Quick Start

{
  "businessUrls": [
    "https://www.yelp.com/biz/franklin-barbecue-austin",
    "https://www.yelp.co.uk/biz/dishoom-london",
    "https://www.yelp.ca/biz/schwartzs-montr%C3%A9al-4"
  ]
}

More examples:

• Aliases instead of links: {"businessUrls": ["tartine-bakery-san-francisco-3", "katzs-delicatessen-new-york"]}
• A Yelp business id: {"businessUrls": ["MGzro82Fi4LYvc86acoONQ"]}
• Photo or menu links work too: {"businessUrls": ["https://www.yelp.com/biz_photos/bi-rite-creamery-san-francisco"]}

Input

Input	Type	Default	Meaning
businessUrls	array	—	Yelp business page links from any Yelp site (yelp.com/biz/..., yelp.ca/biz/..., yelp.co.uk/biz/..., photo and menu pages), the alias at the end of such a link (franklin-barbecue-austin) or a 22-character Yelp business id. Up to 5,000 per run.

Give at least one business. The same business given twice (for example as a link and as its alias, or on two Yelp sites) is returned once. Search and review pages are not accepted: open a business from the results and paste its link.

What it returns

The dataset contains one row per business:

Field	Meaning
businessId, alias	Yelp's business id and the business's name in Yelp links (after any rename on Yelp).
name	Business name.
url	The business page on yelp.com.
rating, reviewCount	Average star rating (1 to 5, to one decimal) and the number of reviews. rating is null for a business without reviews.
categories	Yelp categories, for example BBQ & Barbecue.
priceRange	Price range as Yelp shows it, in the business's local currency sign: $$, £££, €.
phone, website, menuUrl	Phone number as Yelp formats it, the business's own website and its menu link.
address, street, city, region, postalCode, countryCode	Full address on one line and its parts.
neighborhoods	Neighbourhoods Yelp places the business in.
latitude, longitude, timezone	Map pin and the business's time zone.
hours	Regular opening hours for each weekday, Mon to Sun, for example ["11:00 AM - 3:00 PM"], ["Closed"] or ["Open 24 hours"].
photosCount	Number of photos and videos on the business page.
amenities	Features Yelp lists, each with name and available, for example Offers delivery: false.
isClosed, isClaimed	Whether Yelp marks the business as closed, and whether the owner has claimed the page.
yearEstablished, about	Year established and the owner's description, when given.
input	The link, alias or id the row was read from.
scrapedAt	Collection time (UTC, ISO 8601).

Fields the business page does not show are null (or an empty list), never guessed.

The run summary (OUTPUT) reports results, errors with the list at sourceErrors, and duplicates (inputs that turned out to be a business already returned).

Example queries

• Lead lists: turn a list of Yelp links into phone numbers, websites and addresses.
• Location data: map businesses by latitude and longitude with their hours and categories.
• Reputation tracking: schedule a run over your locations and track rating and reviewCount.
• Data cleaning: check which businesses on your list Yelp now marks as closed.

Output example

One row, with the amenities list shortened (this business lists 39):

{
  "businessId": "MGzro82Fi4LYvc86acoONQ",
  "alias": "franklin-barbecue-austin",
  "name": "Franklin Barbecue",
  "url": "https://www.yelp.com/biz/franklin-barbecue-austin",
  "rating": 4.5,
  "reviewCount": 6492,
  "categories": [
    "BBQ & Barbecue"
  ],
  "priceRange": "$$$",
  "phone": "(512) 653-1187",
  "website": "https://franklinbbq.com",
  "menuUrl": "https://franklinbbq.com/menu/",
  "address": "900 E 11th St, Austin, TX 78702, United States",
  "street": "900 E 11th St",
  "city": "Austin",
  "region": "TX",
  "postalCode": "78702",
  "countryCode": "US",
  "neighborhoods": [
    "East Austin"
  ],
  "latitude": 30.270135,
  "longitude": -97.731345,
  "timezone": "America/Chicago",
  "hours": [
    {"day": "Mon", "hours": ["Closed"]},
    {"day": "Tue", "hours": ["11:00 AM - 3:00 PM"]},
    {"day": "Wed", "hours": ["11:00 AM - 3:00 PM"]},
    {"day": "Thu", "hours": ["11:00 AM - 3:00 PM"]},
    {"day": "Fri", "hours": ["11:00 AM - 3:00 PM"]},
    {"day": "Sat", "hours": ["11:00 AM - 3:00 PM"]},
    {"day": "Sun", "hours": ["11:00 AM - 3:00 PM"]}
  ],
  "photosCount": 8631,
  "amenities": [
    {"name": "Offers take-out", "available": true},
    {"name": "Takes reservations", "available": false},
    {"name": "Offers delivery", "available": false}
  ],
  "isClosed": false,
  "isClaimed": true,
  "yearEstablished": "2009",
  "about": "With the encouragement of family and friends, Aaron and Stacy Franklin debuted Franklin BBQ in late 2009. 10+ years later, they are still aiming to serve the highest quality meats, friendliest service and most authentic Austin experience as possible.",
  "input": "https://www.yelp.com/biz/franklin-barbecue-austin",
  "scrapedAt": "2026-10-21T03:54:17Z"
}

Failed businesses

A link or alias that Yelp does not know, or a business page that could not be read, is reported in the run summary at OUTPUT.sourceErrors with its input, code and message: NOT_FOUND when Yelp has no business under that name, NOT_RENDERED when Yelp kept sending the page without its business details, BLOCKED when Yelp turned the run's requests away. Failures are never dataset rows and are not charged. If no business at all could be read, the run ends with an error instead of finishing green with an empty dataset.

Limits and caveats

• Business details only: reviews, review text and Yelp search results are not collected.
• Opening hours are the regular weekly hours; holiday hours are not included.
• Yelp sends a renamed or moved business on to its current page; the row then carries the current alias and url, with your original input.
• Some businesses cannot be read even after several tries; they are listed in the run summary as NOT_RENDERED and are not charged. Running them again does not guarantee they will be read.
• Each business takes a few seconds; about 1,000 businesses take 20 to 30 minutes.
• Automated access is subject to Yelp's terms; use this actor only where you have the necessary permissions and a lawful basis, and handle any personal data in line with the privacy laws that apply to you.

FAQ

Do I need a Yelp account? No. Only public business information is collected.

Which Yelp sites are supported? Links from any Yelp site. A business has the same alias on every Yelp site, so a yelp.ca link and a yelp.com link to the same business return the same row.

Why are the hours in English? Rows use English weekday names and Yelp's English hour format whichever Yelp site the link came from.

What is a business alias? The last part of a Yelp business link: franklin-barbecue-austin in yelp.com/biz/franklin-barbecue-austin.

Price

$0.0013 per business row delivered, that is $1.30 per 1,000 businesses, plus $0.005 per run start. The run-start event is charged per GB of memory; the default 512 MB run is one start event. The start is charged even if the run saves no results. Businesses that fail are not charged. When your maximum charge for the run is reached, the run stops and keeps the rows already saved. Platform usage is included in these prices.