yelpr

An R library for theYelp Fusion API

Installation

devtools::install_github( "OmaymaS/yelpr" )

API Authentication

Fromyelp authentication guide:

"In order to set up your access to Yelp Fusion API, you need to create an app with Yelp. This app represents the application you'll build using our API and includes the credentials you'll need to gain access. Here are the steps for creating an app:

• Go toCreate App
• In the create new app form, enter information about your app, then agree to Yelp API Terms of Use and Display Requirements. Then click the Submit button.
• You will now have an API Key. "

Usage

To use the package, it is required to have an API key as clarified in the previous section. In the following examples, we will read the key once from a saved file. You could create your own file or assign the key directly in the code.

#load yelpr package
library(yelpr)

## assign app key
key<-readLines("yelp_app_key.txt")

Business Endpoint

The available functions are:

• business_search()
• business_lookup_id()
• business_search_phone()
• business_search_review()
• business_search_autocomplete()
• business_search_transaction()
• business_match_name()

For examplebusiness_search()returns up to 1000 businesses based on the provided search criteria. The location OR (longitude+latitude) are required, plus Additionaloptional parameters.

Here we will retrieve the first 5 results in new york with the term 'chinese'

#search businesses with keyword 'chinese' in 'New York'
business_ny<-business_search(api_key=key,
location='New York',
term="chinese",
limit=5)

The function returns a list, so we can extract the details of the businessesbusiness_ny$businesses:

id alias
1 k8GFfCXO2FIIJIo0ICYSRA bao-bao-cafe-new-york-3
2 X8ZS-dgiMIJvhwf9SaDnjw wah-fung-no-1-new-york
3 croh2zWlbPyCQTNS11klcg sichuan-manor-new-york-3
4 0CjK3esfpFcxIopebzjFxA joes-shanghai-new-york-2
5 lynQoI3w_pzYfHGeuUU-Qg shu-jiao-fu-zhou-cuisine-restaurant-new-york
name
1 Bao Bao Cafe
2 Wah Fung No 1
3 Sichuan Manor
4 Joe's Shanghai
5 Shu Jiao Fu Zhou Cuisine Restaurant
image_url
1 https://s3-media2.fl.yelpcdn /bphoto/pjJHmOiblI-oVf6NBjgL9g/o.jpg
2 https://s3-media2.fl.yelpcdn /bphoto/QrbtEYSiE_AQkqu59Qmp4Q/o.jpg
3 https://s3-media2.fl.yelpcdn /bphoto/QcWywXc47siclZkYCsxJnQ/o.jpg
4 https://s3-media3.fl.yelpcdn /bphoto/ekUo5egd4dlE7zJyb4-Leg/o.jpg
5 https://s3-media2.fl.yelpcdn /bphoto/TALCyEl-e45rDrKk3vCWaQ/o.jpg
is_closed
1 FALSE
2 FALSE
3 FALSE
4 FALSE
5 FALSE
url
1 https:// yelp /biz/bao-bao-cafe-new-york-3?adjust_creative=ms3wnheA1zMACsW_cG2W_Q&utm_campaign=yelp_api_v3&utm_medium=api_v3_business_search&utm_source=ms3wnheA1zMACsW_cG2W_Q
2 https:// yelp /biz/wah-fung-no-1-new-york?adjust_creative=ms3wnheA1zMACsW_cG2W_Q&utm_campaign=yelp_api_v3&utm_medium=api_v3_business_search&utm_source=ms3wnheA1zMACsW_cG2W_Q
3 https:// yelp /biz/sichuan-manor-new-york-3?adjust_creative=ms3wnheA1zMACsW_cG2W_Q&utm_campaign=yelp_api_v3&utm_medium=api_v3_business_search&utm_source=ms3wnheA1zMACsW_cG2W_Q
4 https:// yelp /biz/joes-shanghai-new-york-2?adjust_creative=ms3wnheA1zMACsW_cG2W_Q&utm_campaign=yelp_api_v3&utm_medium=api_v3_business_search&utm_source=ms3wnheA1zMACsW_cG2W_Q
5 https:// yelp /biz/shu-jiao-fu-zhou-cuisine-restaurant-new-york?adjust_creative=ms3wnheA1zMACsW_cG2W_Q&utm_campaign=yelp_api_v3&utm_medium=api_v3_business_search&utm_source=ms3wnheA1zMACsW_cG2W_Q
review_count
1 26
2 930
3 35
4 4991
5 472
categories
1 noodles, chinese, Noodles, Chinese
2 chinese, Chinese
3 szechuan, dimsum, Szechuan, Dim Sum
4 shanghainese, seafood, venues, Shanghainese, Seafood, Venues & Event Spaces
5 chinese, Chinese
rating coordinates.latitude coordinates.longitude
1 4.5 40.70854 -74.01367
2 4.5 40.71735 -73.99457
3 4.5 40.75817 -73.98831
4 4.0 40.71467 -73.99776
5 4.5 40.71843 -73.99169
transactions price location.address1
1 delivery, pickup $ 106 Greenwich St
2 restaurant_reservation $ 79 Chrystie St
3 restaurant_reservation, delivery, pickup $$$ 258 W 44th St
4 $$ 9 Pell St
5 pickup, restaurant_reservation $ 118 Eldridge St
location.address2 location.address3 location.city location.zip_code
1 <NA> New York 10006
2 New York 10002
3 <NA> New York 10036
4 New York 10013
5 <NA> <NA> New York 10002
location.country location.state location.display_address
1 US NY 106 Greenwich St, New York, NY 10006
2 US NY 79 Chrystie St, New York, NY 10002
3 US NY 258 W 44th St, New York, NY 10036
4 US NY 9 Pell St, New York, NY 10013
5 US NY 118 Eldridge St, New York, NY 10002
phone display_phone distance
1 +19172617122 (917) 261-7122 1663.255
2 +12129255175 (212) 925-5175 1323.285
3 +16467670854 (646) 767-0854 5884.486
4 +12122338888 (212) 233-8888 1066.509
5 +12126252532 (212) 625-2532 1460.313

Events Endpoint

The available functions are:

• event_lookup_id()
• event_search()
• event_search_featured()

For example,event_search_featuredreturns the featured event, chosen by Yelp's community managers, for a given location. The location OR (longitude+latitude) are required.

Here we'll get the details of featured event in the given location using the longitude and latitude.

#search featured event in the given location coordinates
event<-event_search_featured(api_key=key,
longitude="-74.01385",latitude="40.70387")

And the event nameevent$namewould be: 52 Things To Do in 2018