yelpapi

What it is and what it does

yelpapi is a pure Python client for the Yelp Fusion API that abstracts away HTTP details and session management. It provides methods to search for businesses, retrieve business details, read reviews, look up events, and access engagement metrics—all through a simple, context-manager-friendly interface. The library uses requests.Session internally for connection pooling, which improves performance when making multiple API calls.

The package is designed to be robust to Yelp API changes and requires only requests as a runtime dependency. It supports Python 3.9 through 3.14 and has been actively maintained since 2013. You instantiate YelpAPI with your API key, optionally set a timeout, and then call methods like search_query(), business_query(), reviews_query(), or event_search_query() to retrieve data.

Use it for:

• Search for restaurants, shops, or services in a specific location and retrieve ratings, hours, and contact info.
• Aggregate and analyze customer reviews and review highlights for businesses you track.
• Build a local business directory or comparison tool that pulls live data from Yelp.
• Query Yelp's event listings and featured events for a given area.
• Match business names and phone numbers against Yelp's database to enrich your own data.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

yelpapi wraps the Yelp Fusion API, letting you search for businesses, retrieve reviews, check events, and query business details programmatically from Python.

Yes. yelpapi is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. Install it if you need to integrate Yelp business data into a Python application. The main prerequisite is obtaining a Yelp Fusion API key; the library itself is straightforward to use.

Install

yelpapi on PyPI

pip install yelpapi

uv add yelpapi

poetry add yelpapi

Installing yelpapi

Before you install

Low install friction with a single dependency on requests. The package is actively maintained with a recent release (149 days ago) and has been stable since its early releases in 2013.

License in practice

BSD 3-Clause License (permissive) requires attribution but places no restrictions on commercial or private use. You are free to use, modify, and distribute this code provided you retain the license notice.

Quickstart

pip install yelpapi

from yelpapi import YelpAPI
with YelpAPI(api_key) as yelp_api:
    search_results = yelp_api.search_query(location='San Francisco', term='coffee')

Requires a valid Yelp Fusion API key (obtain from Yelp's developer portal) and Python 3.9 or higher.

Verify before relying

• Rate limits and quota behavior of the Yelp Fusion API and how yelpapi handles them.
• Whether all Yelp Fusion API endpoints are fully covered or if some are missing.
• Performance characteristics when making large numbers of concurrent requests.

Package facts

Evidence: yelpapi-2.6.0-py3-none-any.whl

Tags

More Python Modules packages