This software is licensed under the BSD 3-Clause License. Please refer to the separate LICENSE file for the exact text of the license. You are obligated to give attribution if you use this code.

yelpapi is a pure Python implementation of the Yelp Fusion API. It is simple, fast, and robust to any changes Yelp may make to the API in the future.

This code requires Python 3.8 or higher and requests.

yelpapi is available on PyPI at https://pypi.org/project/yelpapi/.

Install using pip:

pip install yelpapi

Install from source:

python setup.py install

This API is demonstrated more thoroughly in examples.py, but the following chunk of code demonstrates basic use of yelpapi:

from yelpapi import YelpAPI
with YelpAPI(api_key) as yelp_api:
    search_results = yelp_api.search_query(args)

You can also set timeouts so API calls do not block indefinitely in degraded network conditions:

from yelpapi import YelpAPI
with YelpAPI(api_key, timeout_s=3.0) as yelp_api:
    search_results = yelp_api.search_query(args)

Under the covers, this module uses a requests.Session object for issuing all API calls, which offers potentially significant performance benefits over issuing separate API calls outside of a session. You should be sure to close the underlying session when all API interactions are complete. The above examples demonstrate using the class as a context manager, which will automatically close the connection when you're done and is the preferred way of using the class, but you can also manually close it like this if a context manager won't work for your use case:

from yelpapi import YelpAPI
try:
    yelp_api = YelpAPI(api_key)
    search_results = yelp_api.search_query(args)
finally:
    yelp_api.close()

• Autocomplete API - autocomplete_query(...)
• Business API - business_query(...)
• Business Match API - business_match_query(...)
• Event Lookup API - event_lookup_query(...)
• Event Search API - event_search_query(...)
• Featured Event API - featured_event_query(...)
• Phone Search API - phone_search_query(...)
• Reviews API - reviews_query(...)
• Search API - search_query(...)
• Transaction Search API - transaction_search_query(...)