thunter009 / yelpapi

yelpapi is a pure Python implementation of the Yelp Fusion API (aka Yelp v3 API).

yelpapi

AUTHOR

Geoffrey Fairchild

• https://www.gfairchild.com/
• https://github.com/gfairchild
• https://www.linkedin.com/in/gfairchild/

LICENSE

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

ABOUT

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

REQUIREMENTS

This code requires Python 3.4 or higher and requests.

INSTALL

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

Install using pip:

pip install yelpapi

Install from source:

python setup.py install

USING THIS CODE

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

from yelpapi import YelpAPI
yelp_api = YelpAPI(api_key)
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
yelp_api = YelpAPI(api_key, timeout_s=3.0)
search_results = yelp_api.search_query(args)

METHODS

• 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(...)