Provides a convenient Java Client Library for interfacing with Yelp
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Jenkins Travis Maven Central Version

The YelpJavaClient provides a simple Java interface for interacting with Yelp's API.




Creating a Client

Create a client using the App ID and App Secret that you obtained from the Yelp Developer console.

String clientId = "...";
String clientSecret = "...";
YelpAPI yelp = YelpAPI.newInstance(clientId, clientSecret);

Searching Businesses

Yelp API Documentation

Searching businesses is as easy as making a request object and using the searchForBusinesses() method.

//Create a request object
YelpSearchRequest request =  YelpSearchRequest.newBuilder()
    .withCoordinate(Coordinate.of(34.018363, -118.492343))

//Make the request
List<YelpBusiness> results = yelp.searchForBusinesses(request);"Found {} results for request {}", results.size(), request);

Business Details

Yelp API Documentation

Sometimes you want more detailed information about a business, such as the business hours, additional photos, and price information.

Simply call the getBusinessDetails() method.

//Using any business
YelpBusiness business = Lists.oneOf(results);

//Make the request to get business details.
YelpBusinessDetails businessDetails = yelp.getBusinessDetails(business);"Received detailed info for business named {}: [{}]",, businessDetails);

if (businessDetails.isOpenNow())
{"{} is open now.",


Yelp API Documentation

YelpBusiness business = Lists.oneof(business);
List<YelpReview> reviews = yelp.getReviewsForBusiness(business);"Business named")


Currently Unsupported

We do not yet support the following API calls:

Guiding Philosophy

We used Alchemy Design Principles when designing this library.


We wanted our code to feel like it was barely there. This meant keeping things minimal and light.


Yelp already designed a great intuitive API. We didn't want to add a pool of unnecessary soda.


Nearly everything is unit tested, and it is already being used in production by BlackNectar, and others.


We wanted you to have fun, and to feel powerful.
We ditched the no-fun java get() set() pojo style in favor of open public variables. We trust you.


This Software is licensed under the Apache 2.0 License