Yelp API

Our Yelp API gives you programmatic access to Yelp data that isn't available through any official API. Get data on business information, reviews, ratings, photos, event details, user collections, and more. And the best part? You can try the Yelp API entirely for free, no credit card required.

Try Yelp API

Trusted by industry leaders all over the world

Integrate our Yelp API

Access the Yelp API using Python, JavaScript, CLI, cURL, OpenAPI, or MCP. Choose your preferred option and start extracting Yelp data in minutes.

Python

JavaScript

HTTP

MCP

1from apify_client import ApifyClient
2
3# Initialize the ApifyClient with your Apify API token
4# Replace '<YOUR_API_TOKEN>' with your token.
5client = ApifyClient("<YOUR_API_TOKEN>")
6
7# Prepare the Actor input
8run_input = {
9    "search": "grill",
10    "searchLocation": "Los Angeles",
11    "endPageForPhotos": 1,
12    "reviewSort": "relevance_desc",
13    "startUrls": [
14        "https://www.yelp.com/biz/maxs-restaurant-glendale-glendale-3",
15        "https://www.yelp.com/search?find_desc=max&find_loc=Los+Angeles%2C+CA",
16        "https://www.yelp.com/collection/qGqt9YpsLBCH5nruuVCK2A/Food",
17        "https://www.yelp.com/collections/user?userid=a_UbCGv_MTAHFs3P_zxUDA",
18        "https://www.yelp.com/events/la/browse?start_date=20230215",
19        "https://www.yelp.com/events/monterey-park-monterey-park-strong-star-ballroom-shooting-community-resources",
20    ],
21    "maxItems": 20,
22    "endPage": 1,
23    "startPageForReviews": 1,
24    "endPageForReviews": 1,
25    "extendOutputFunction": "($) => { return {} }",
26    "customMapFunction": "(object) => { return {...object} }",
27    "proxy": { "useApifyProxy": True },
28}
29
30# Run the Actor and wait for it to finish
31run = client.actor("epctex/yelp-scraper").call(run_input=run_input)
32
33# Fetch and print Actor results from the run's dataset (if there are any)
34print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
35for item in client.dataset(run["defaultDatasetId"]).iterate_items():
36    print(item)
37
38# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

Yelp API in Python

Yelp API in JavaScript

Yelp MCP server

Yelp API in CLI

Get data with Yelp API

Extract Yelp data by providing search keywords, locations, or direct URLs to businesses, events, and collections. The Yelp scraper returns structured JSON data with business details, ratings, reviews, photos, addresses, operating hours, and comprehensive business information.

Input

{
 "proxy": {
  "useApifyProxy": true
 },
 "search": "max",
 "endPage": 1,
 "maxItems": 20,
 "startUrls": [
  "<https://www.yelp.com/biz/maxs-restaurant-glendale-glendale-3>",
  "<https://www.yelp.com/search?find_desc=max&find_loc=Los+Angeles%2C+CA>",
  "<https://www.yelp.com/collection/qGqt9YpsLBCH5nruuVCK2A/Food>",
  "<https://www.yelp.com/collections/user?userid=a_UbCGv_MTAHFs3P_zxUDA>",
  "<https://www.yelp.com/events/la/browse?start_date=20230215>",
  "<https://www.yelp.com/events/monterey-park-monterey-park-strong-star-ballroom-shooting-community-resources>"
 ],
 "includePhotos": true,
 "includeReviews": true,
 "searchLocation": "Los Angeles",
 "endPageForPhotos": 2,
 "endPageForReviews": 1
}

Output

{
 "url": "https://www.yelp.com/biz/good-grill-express-los-angeles-2",
 "type": "business",
 "title": "Good Grill Express",
 "rating": 2.9,
 "address": {
  "city": "Los Angeles",
  "formatted": "210 E Olympic Blvd 108-127\nSte 127-108\nLos Angeles, CA 90015",
  "postalCode": "90015",
  "regionCode": "CA",
  "addressLine1": "210 E Olympic Blvd 108-127",
  "addressLine2": "Ste 127-108",
  "addressLine3": null
 },
 "reviews": [
  {
   "date": "2024-01-10T22:39:14.000Z",
   "author": {
    "_fromStrapi": true,
    "id": "DTXMbSRoCqJU6eC0RWuZ0A",
    "name": "Johanna T.",
    "isElite": false,
    "location": "Boyle Heights, Los Angeles, CA",
    "photoUrls": {
     "userSrc": "https://s3-media0.fl.yelpcdn.com/photo/VHLQJjz9X8sTMKt6s9K5nA/60s.jpg",
     "userSrcSet200x": "https://s3-media0.fl.yelpcdn.com/photo/VHLQJjz9X8sTMKt6s9K5nA/120s.jpg",
     "userSrcSet300x": "https://s3-media0.fl.yelpcdn.com/photo/VHLQJjz9X8sTMKt6s9K5nA/180s.jpg",
     "mediaItemSrcUrl": "https://s3-media0.fl.yelpcdn.com/photo/VHLQJjz9X8sTMKt6s9K5nA/30s.jpg",
     "mediaItemSrcSetUrl200x": "https://s3-media0.fl.yelpcdn.com/photo/VHLQJjz9X8sTMKt6s9K5nA/60s.jpg",
     "mediaItemSrcSetUrl300x": "https://s3-media0.fl.yelpcdn.com/photo/VHLQJjz9X8sTMKt6s9K5nA/90s.jpg"
    },
    "friendCount": 0,
    "reviewCount": 12,
    "businessPhotoCount": 20
   },
   "rating": 5,
   "review": "I have a business in the neighborhood and ordered from this place from a flyer dropped at my store. I ordered a chicken soup and chicken flautas. The chicken soup was flavorful and abundant with veggies. The chicken flautas were delicious and not to mention the combo of salsa, sour cream and guacamole had my mouth watering. I will definitely order from here again.",
   "isElite": false,
   "userUrl": "https://www.yelp.com/user_details?userid=DTXMbSRoCqJU6eC0RWuZ0A",
   "feedback": {
    "coolCount": 0,
    "funnyCount": 0,
    "usefulCount": 0
   },
   "userName": "Johanna T.",
   "reviewLanguage": "en"
  }
 ],
 "businessId": "rbcOzsLyUv4D8H1VyfKhcQ",
 "categories": [
  "Mexican",
  "Seafood",
  "American"
 ],
 "priceRange": "$",
 "coordinates": [
  {
   "latitude": 34.038995,
   "longitude": -118.2555
  }
 ],
 "reviewCount": 44,
 "primaryPhoto": "https://s3-media0.fl.yelpcdn.com/bphoto/VUpvBRGaf7iWklEasbI6OA/o.jpg"
}

How to use Yelp API

Sign up for Apify account01

Creating an account is quick and free — no credit card required. Your account gives you access to more than 5,000 scrapers and APIs.

Get started for free

Get your Apify API token02

Go to settings in the Apify console and navigate to the “API & Integrations” tab. There, create a new token and save it for later.

Integrate Yelp API03

Navigate to the Yelp API page and click on the API dropdown menu in the top right corner. In the dropdown menu, you can see API clients, API endpoints, and more.

Open Yelp API

Get your Yelp data via API04

Now, you can use the API and get the data you need from Yelp.

Why use Apify?

Never get blocked

Every plan (free included) comes with Apify Proxy, which is great for avoiding blocking and giving you access to geo-specific content.

Customers love us

We truly care about the satisfaction of our users and thanks to that we're one of the best-rated data extraction platforms on both G2 and Capterra.

Monitor your runs

With our latest monitoring features, you always have immediate access to valuable insights on the status of your web scraping tasks.

Export to various formats

Your datasets can be exported to any format that suits your data workflow, including Excel, CSV, JSON, XML, HTML table, JSONL, and RSS.

Integrate Apify to your workflow

You can integrate your Apify runs with platforms such as Zapier, Make, Keboola, Google Drive, or GitHub. Connect with practically any cloud service or web app.

Large developer community

Apify is built by developers, so you'll be in good hands if you have any technical questions. Our Discord server is always here to help!

Get AI-ready Yelp data via API

Connect to hundreds of apps right away using ready-made integrations, or set up your own with webhooks and our API.

Frequently asked questions

Yes, Yelp provides an official API for developers. However, the official Yelp API has significant limitations including rate limits, restricted data access, and requires API key approval. Our Yelp scraper provides unrestricted access to public Yelp data including unlimited reviews, complete business information, photos, events, and collections without the constraints of the official API.

Yes, you can try our Yelp scraper for free on the Apify platform. New users receive free compute units to test the actor. You can scrape up to 100 listings in approximately 2 minutes using only 0.02-0.12 compute units, making it very cost-effective to evaluate the tool's capabilities before committing to larger projects.

You can extract comprehensive business data including business IDs, names, ratings, review counts, price ranges, categories, complete addresses with coordinates, phone numbers, operating hours, amenities, photos, detailed reviews with user information, FAQ sections, rating distributions, menus, websites, and event information. The scraper also supports extracting user collections and event details with subscriber information.

Yes, it is legal to scrape publicly available data from Yelp for legitimate business purposes such as market research, competitor analysis, and business intelligence. Our scraper only accesses publicly visible information that users have chosen to make available. However, you should always comply with Yelp's terms of service and use the data responsibly, avoiding any activities that could harm the platform or violate user privacy.

Getting started is simple: 1) Sign up for a free Apify account, 2) Navigate to the Ultimate Yelp Scraper actor page, 3) Configure your input parameters including search keywords, locations, or direct URLs to Yelp businesses/events, 4) Set up proxy configuration (required), 5) Customize options like including reviews, photos, and page limits, 6) Run the actor and download results in JSON, CSV, or other formats. The actor requires proxy servers which you can use through Apify Proxy or your own proxy solution.