Yelp API Python Client

Extract Yelp data with our Yelp API Python client. Get programmatic access to photos, user collections, business information, event details, reviews, ratings, and more using simple Python code. Start free, no credit card required.

Try Yelp API Python Client

Trusted by industry leaders all over the world

Integrate our Yelp API

The Apify API client for Python is the official library that allows you to use Yelp API in Python, providing convenience functions and automatic retries on errors. Get started with simple pip installation and robust error handling built-in.

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

Yelp API in JavaScript

Yelp MCP server

Yelp API in CLI

Get data with Yelp API Python client

Use our Python API client to extract Yelp data by providing search keywords, locations, or direct URLs to businesses, events, and collections. The API returns structured data, including business details, ratings, reviews, photos, addresses, operating hours, and comprehensive business information in JSON format.

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",
     "__typename": "UserPhotoUrl",
     "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

Install Apify Python client02

Install the Apify Python client using pip: pip install apify-client. This package provides a simple interface to interact with Yelp API from your Python applications.

Get your Apify API token03

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 API04

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. Use the provided Python code examples to integrate Yelp API into your Python application.

Open Yelp Python API

Get your Yelp data via API05

The Yelp API returns structured JSON data that works perfectly with pandas, NumPy, and other Python data analysis libraries.

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!

Python-ready Yelp data extraction

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 Python API client for developers. However, the official Yelp Python API client 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 Python API client.

Yes, you can try our Yelp Python API client 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 Python API client's capabilities before committing to larger projects.

You can retrieve 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 through Python API requests. The Python API client also supports retrieving user collections and event details with subscriber information.

Yes, it is legal to scrape publicly available data from Yelp using a Python API client for legitimate business purposes such as market research, competitor analysis, and business intelligence. The Python API client 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 with our Yelp Python API is easy — simply create a free Apify account, get your API token, and start using the Yelp API in Python, JavaScript, CLI, cURL, OpenAPI, or MCP.