---
id: yelpapi
version: "2.6.0"
license: Copyright (c) 2013, Triad National Security, LLC All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# yelpapi — yelpapi is a pure Python implementation of the Yelp Fusion API.

License: permissive · Maintenance: active · Downloads: 92.7K/mo

## 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 above — 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

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

- License: Copyright (c) 2013, Triad National Security, LLC All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 92.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

yelp api client python, yelp business search, yelp fusion api wrapper, query yelp reviews programmatically, yelp business data python, yelp events and listings, yelp autocomplete search, api-client, yelp-integration, business-data

[View on SkillFed](https://skillfed.io/packages/yelpapi) · [View on PyPI](https://pypi.org/project/yelpapi/)