Demo to preview the settings

Introduction

Search Yelp's businesses, business reviews and events with a variety of optional parameters.

Prerequisites

  1. You must have the Yelp account.

How to set up

Register your application

Log in to your Yelp account and create a new application here: https://www.yelp.com/developers/v3/manage_app

Get your API Key

After submitting a few details about your app, a new API Key will be created for you.
New API Key created in Yelp app settings
New API Key created in Yelp app settings
Copy that key and paste it into the plugin settings in your app with the word "Bearer" and a space in front of the key. For example: "Bearer API-KEY”
Plugin settings in Bubble app
Plugin settings in Bubble app
Now, you're ready to use this plugin in your app! Refer to the next pages in this documentation to understand how to work with the various data calls.

Business Search

Use this data source when you have general info on the business like name & location but don't know the address.

Add a Repeating Group element to your page

Type = "Business Search Businesses (Yelp)"
Data Source = Get data from external API > "Yelp - Business Search's Businesses"
Image without caption

Map search inputs to the data source settings

Image without caption

Display Business details inside the repeating group cell

You can find a full breakdown of all the parameter options and possible business attributes here: https://docs.developer.yelp.com/reference/v3_business_search

Business Match

Use this data source when you have precise info like name & address.

Add a Repeating Group element to your page

Type = "Business Match Businesses (Yelp)"
Data Source = Get data from external API > "Yelp - Business Match's Businesses"
Image without caption

Map search inputs to the data source settings

Remember, this data source is for when you know exactly which business you want, so all fields are required. If you're looking to do a more general search, use the "Business Search" data source instead.

Display Business details inside the repeating group cell

Image without caption
You can find a full breakdown of all the parameter options and possible business attributes here: https://docs.developer.yelp.com/reference/v3_business_match

Business Reviews

Use this data source to retrieve reviews for a specific business.
In order to find a list of reviews, you'll need a Business ID, which you can get from the Business Search or Business Match data sources.
In our plugin demo, we have a button that opens a popup from within a Business Search result:
Image without caption
The popup's type of content matches the repeating group's type of content:
Image without caption
In the button click workflow, we're showing the popup and also "displaying data" to pass the cell's data source to the popup:
Image without caption
Now, the repeating group inside the popup can reference a list of reviews for this specific business by ID. Be mindful of the type of content of this second repeating group -- "Business Reviews reviews”
Image without caption
From here, you can display information about each review inside the repeating group cell (inside the popup). For example, we're using a Star Rating plugin to display the Review's "rating" value (a number) via stars.
Image without caption
Take a look at the plugin demo to see what this looks like from the user's perspective: https://cnca-plugins.bubbleapps.io/version-test/plugin-yelp

Event Search

Use this data source to find events that match your search filters.

Add a Repeating Group element to your page

Type = "Event Search event (Yelp)"
Data Source = Get data from external API > "Yelp - Event Search's events"
Image without caption

Map search inputs to the data source settings

All of these search parameters are optional, but you'll want at least one to begin a search.
Location: This can be a free text for a city name
Start and End date: These should be the UNIX values of a date/time. We suggest using a date/time picker, extracting the UNIX value from there, and truncating to the first 10 characters as that's what is compatible with Yelp.
Categories: You can add one or more categories from Yelp's full Category list. We have a separate data source to retrieve this list. The value in this search setting should be a Category "Alias". In our demo, we have a multi-select dropdown to make it easy for the user to choose Categories.
Is_Free: This is a boolean value that should be formatted as "true" or "false", not "yes" or "no"
Image without caption

Display Event details inside the Repeating Group cell

Image without caption
You can find a full breakdown of event information here: https://docs.developer.yelp.com/reference/v3_events_search
We also suggest you take a look at our demo page here: https://bubble.io/page?type=page&name=plugin-yelp&id=cnca-plugins&tab=tabs-1

Event Categories

In order to get a list of Event Categories, you'll need to enable the "Developer Beta" feature in your Yelp app settings. This just means clicking a button to enable:
Image without caption
In our demo page, we're using a multi-select dropdown to offer the user an official list of categories to choose from to then filter the event search:
Type of content = List Categories categorie (Yelp)
Data source = Yelp - List Categories's categories
Image without caption
Note that the caption for the multi-select dropdown is the category's title, but for the Event Search, you'll want to reference its alias, not title.

Changelogs

Update 26.06.23 - Version 5.1.0

  • updated description

Update 07.02.23 - Version 5.0.0

  • Updated Event Time Start/End to be recognized as dates

Update 07.02.23 - Version 4.0.0

  • Added Categories data source for Event Search (must enable beta in your Yelp app settings), updated documentation

Update 01.02.21 - Version 3.2.0

  • Updates to the Business Search data source. Please check your implementation -- filters may need re-linking.

Update 11.07.19 - Version 3.1.0

  • Plugin instructions update

Update 10.06.19 - Version 3.0.0

  • Yelp retired the "Business Lookup" data call and replaced it with "Business Match." You can still use "Business Match" to find a business, but you now need to provide the first line of the address. Sometimes just the street name is enough.

Update 05.09.18 - Version 2.0.0

  • Added event search and consolidated authorization method so that all you need is your API key

Update 14.08.17 - Version 1.0.0

  • Beta v1

Powered by Notaku