All Projects → Yelp → Yelp Python

Yelp / Yelp Python

Licence: mit
A Python library for the Yelp API

Programming Languages

python
139335 projects - #7 most used programming language

Projects that are alternatives of or similar to Yelp Python

Bigcommerce Api Php
Connect PHP applications with the Bigcommerce Platform
Stars: ✭ 128 (-21.47%)
Mutual labels:  api-client
Chorale
Chorale is a set of tools for interacting with Notion and Notion content.
Stars: ✭ 140 (-14.11%)
Mutual labels:  api-client
Piazza Api
Unofficial Client for Piazza's Internal API
Stars: ✭ 149 (-8.59%)
Mutual labels:  api-client
Vsphere Automation Sdk Java
Java samples, language bindings, and API reference documentation for vSphere, VMC, and NSX-T using the VMware REST API
Stars: ✭ 132 (-19.02%)
Mutual labels:  api-client
Laravel Api Explorer
API explorer for laravel applications
Stars: ✭ 138 (-15.34%)
Mutual labels:  api-client
Virustotalnet
A full implementation of the VirusTotal 2.0 API
Stars: ✭ 142 (-12.88%)
Mutual labels:  api-client
Anyapi
AnyAPI is a library that helps you to write any API wrappers with ease and in pythonic way.
Stars: ✭ 126 (-22.7%)
Mutual labels:  api-client
Sypht Python Client
A python client for the Sypht API
Stars: ✭ 160 (-1.84%)
Mutual labels:  api-client
Mockbin
Mock, Test & Track HTTP Requests and Response for Microservices
Stars: ✭ 1,782 (+993.25%)
Mutual labels:  api-client
Algoliasearch Client Go
⚡️ A fully-featured and blazing-fast Go API client to interact with Algolia.
Stars: ✭ 147 (-9.82%)
Mutual labels:  api-client
Messaging Apis
Messaging APIs for multi-platform
Stars: ✭ 1,754 (+976.07%)
Mutual labels:  api-client
Netsuite Php
NetSuite PHP API Client with namespaces and autoloading
Stars: ✭ 136 (-16.56%)
Mutual labels:  api-client
Thehive4py
Python API Client for TheHive
Stars: ✭ 143 (-12.27%)
Mutual labels:  api-client
Redmine Net Api
.Net API for Redmine bug/task management systems.
Stars: ✭ 131 (-19.63%)
Mutual labels:  api-client
Routeros Api Php
Mikrotik RouterOS API PHP client for your applications
Stars: ✭ 152 (-6.75%)
Mutual labels:  api-client
Cloudflare Rs
Rust library for the Cloudflare v4 API
Stars: ✭ 126 (-22.7%)
Mutual labels:  api-client
Dropbox api
Ruby client library for Dropbox API v2
Stars: ✭ 142 (-12.88%)
Mutual labels:  api-client
Python Qbittorrent
Python wrapper for qBittorrent Web API (for versions above v3.1.x)
Stars: ✭ 163 (+0%)
Mutual labels:  api-client
Wos
📚 Web of Science python client
Stars: ✭ 152 (-6.75%)
Mutual labels:  api-client
Mega.py
Python library for the https://mega.nz/ API.
Stars: ✭ 145 (-11.04%)
Mutual labels:  api-client

Build Status Coverage Status

yelp-python

A Python library for the Yelp Fusion API. It simplifies the process of request construction, and response parsing for Python developers. This clientlib is built and tested on Python 2.7 and 3.6.

Please file issues on this repository for bugs/feature requests for this python client. For bugs/features requests for the Yelp Fusion API itself, please open issues on the dedicated Yelp Fusion repository.

Installation

Install yelp-python from PyPI using:

pip install yelp

Usage

Basics

You must have a Yelp Fusion API key to make requests to the API. Sign up for an API key at https://www.yelp.com/developers/v3/manage_app. Instantiate yelp.client.Client with your API key, and start making requests!

from yelp.client import Client

MY_API_KEY = "abcefghijklmnopqrstuvqwxy123456789" #  Replace this with your real API key

client = Client(MY_API_KEY)

Now you can use the client object to make requests.

Business Details Endpoint

Endpoint documentation: https://www.yelp.com/developers/documentation/v3/business

To query the Business Details Endpoint use the busines.get_by_id function with a Yelp business alias (i.e. yelp-san-francisco) or ID (i.e. 4kMBvIEWPxWkWKFN__8SxQ). You can also pass in the locale parameter as specified in the Business Details Endpoint Documentation.

> business_response = client.business.get_by_id('yelp-san-francisco')

> business_response
Business(alias='yelp-san-francisco', attributes=None, categories=[Category(alias='massmedia', title='Mass Media')], coordinates=Coordinates(latitude=37.7867703362929, longitude=-122.399958372115), display_phone='(415) 908-3801', hours=[Hours(hours_type='REGULAR', is_open_now=True, open=[DayHours(day=0, end='1800', is_overnight=False, start='0800'), DayHours(day=1, end='1800', is_overnight=False, start='0800'), DayHours(day=2, end='1800', is_overnight=False, start='0800'), DayHours(day=3, end='1800', is_overnight=False, start='0800'), DayHours(day=4, end='1800', is_overnight=False, start='0800')])], id='4kMBvIEWPxWkWKFN__8SxQ', image_url='https://s3-media2.fl.yelpcdn.com/bphoto/nQK-6_vZMt5n88zsAS94ew/o.jpg', is_claimed=True, is_closed=False, location=Location(address1='140 New Montgomery St', address2='', address3='', city='San Francisco', country='US', cross_streets='Natoma St & Minna St', display_address=['140 New Montgomery St', 'San Francisco, CA 94105'], state='CA', zip_code='94105'), name='Yelp', phone='+14159083801', photos=['https://s3-media2.fl.yelpcdn.com/bphoto/nQK-6_vZMt5n88zsAS94ew/o.jpg', 'https://s3-media2.fl.yelpcdn.com/bphoto/yFHIb9gob4TzhKUemMOPww/o.jpg', 'https://s3-media1.fl.yelpcdn.com/bphoto/EHCfkEpZraIfPl8gvCo1tg/o.jpg'], rating=2.0, review_count=8421, transactions=[], url='https://www.yelp.com/biz/yelp-san-francisco?adjust_creative=wpr6gw4FnptTrk1CeT8POg&utm_campaign=yelp_api_v3&utm_medium=api_v3_business_lookup&utm_source=wpr6gw4FnptTrk1CeT8POg')

Contributing

  1. Fork it (http://github.com/yelp/yelp-python/fork)
  2. Setup your virtual environment
$ pip install tox
$ tox -e venv
$ . venv-yelp/bin/activate
  1. Create your feature branch (git checkout -b my-new-feature)
  2. Commit your changes (git commit -am 'Add some feature')
  3. Push to the branch (git push origin my-new-feature)
  4. Create new Pull Request

Testing

Please write tests for any new features. We use pytest + tox so just run tox to run the full test suite. Full py.test documentation here.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].