Search

Required if either latitude or longitude is not provided. This string indicates the geographic area to be used when searching for businesses. Examples: "New York City", "NYC", "350 5th Ave, New York, NY 10118". Businesses returned in the response may not be strictly within the specified location.

Required, if location is not provided. Latitude of the location to search from. If latitude is provided, longitude is required too.

Required if location is not provided. Longitude of the location to search from. If longitude is provided, latitude is required too.

Search term, e.g. "food" or "restaurants". The term may also be the business's name, such as "Starbucks". If term is not included the endpoint will default to searching across businesses from a small number of popular categories.

A suggested search radius in meters. This field is used as a suggestion to the search. The actual search radius may be lower than the suggested radius in dense urban areas, and higher in regions of less business density. If the specified value is too large, a AREA_TOO_LARGE error may be returned. The max value is 40,000 meters (about 25 miles).

Categories to filter the search results with. See the list of supported categories. The category filter can be a list of comma delimited categories. e.g., "bars,french" will filter by Bars OR French. The category alias should be used (e.g. "discgolf", not "Disc Golf").

Locale code in the format of {language code}_{country code}. See the list of supported locales.

Pricing levels to filter the search result with: 1 = $, 2 = $$, 3 = $$$, 4 = $$$$. The price filter can be a list of comma delimited pricing levels. e.g., "1, 2, 3" will filter the results to show the ones that are $, $$, or $$$.

When set to true, only return the businesses that are open now. Notice that open_at and open_now cannot be used together.

An integer representing the Unix time in the timezone of the search location. If specified, it will return businesses open at the given time. Notice that open_at and open_now cannot be used together.

Try these additional filters to return specific search results!

• hot_and_new - popular businesses which recently joined Yelp
• request_a_quote - businesses which actively reply to Request a Quote inquiries
• reservation - businesses with Yelp Reservations bookings enabled on their profile page
• waitlist_reservation - businesses with Yelp Wait List bookings enabled on their profile screen (iOS/Android)
• gender_neutral_restrooms - businesses which provide gender neutral restrooms
• open_to_all - businesses which are Open To All
• wheelchair_accessible - businesses which are Wheelchair Accessible

**Premium Search Filters, available to users with a Yelp Places Premium Plan:

• accepts_credit_cards - businesses which accepts credit cards
• Ambience
  • ambience - ambience of the business
  • ambience_casual - is the ambience at the business casual
  • ambience_classy - is the ambience at the business classy
  • ambience_divey - is the ambience at the business divey
  • ambience_hipster - is the ambience at the business hippy
  • ambience_intimate - is the ambience at the business intimate
  • ambience_romantic - is the ambience at the business romantic
  • ambience_touristy - is the ambience at the business touristy
  • ambience_trendy - is the ambience at the business trendy
  • ambience_upscale - is the ambience at the business upscale
• dogs_allowed - dog-friendly businesses
• good_for_dancing - businesses which are good for dancing
• happy_hour - businesses which have happy hour specials
• Liked by
  • liked_by_beer - businesses liked by people who drink beer
  • liked_by_dates - businesses liked by people who are on a date
  • liked_by_fifties - businesses liked by people who are in their fiftees
  • liked_by_forties - businesses liked by people who are in their forties
  • liked_by_genx - businesses liked by people who belong to Generation X
  • liked_by_thirties - businesses liked by people who are in their thirties
  • liked_by_twenties - businesses liked by people who are in their twenties
  • liked_by_men - businesses liked by men
  • liked_by_students - businesses liked by Students
  • liked_by_travelers - businesses liked by people who are travelling
  • liked_by_vegetarians - businesses which are liked by vegetarians
  • liked_by_wine - businesses liked by people who drink wine
  • liked_by_women - businesses liked by women
  • liked_by_young_professionals - businesses liked by young prefessionals
• Noise level
  • noise_level - noise level at the business
  • noise_level_average - is the noise level average
  • noise_level_loud - is the noise level loud
  • noise_level_quiet - is the noise level quiet
  • noise_level_very_loud - is the noise level very loud
• outdoor_seating - businesses with outdoor seating areas
• Parking
  • parking - businesses with parking
  • parking_garage - businesses which itself has a garage or there is a parking garage nearby
  • parking_lot - businesses which have a parking lot
  • parking_street - businesses with street parking available nearby
  • parking_valet - businesses which offer a valet parking
  • parking_validated - businesses which can validate a parking ticket from an external parking
  • parking_bike - businesses with bike parking type
• restaurants_delivery - restaurants which offer delivery service
• restaurants_takeout - restaurants with take-out option
• WiFi
  • wifi - businesses with WiFi
  • wifi_free - businesses with free WiFi
  • wifi_paid - businesses with paid WiFi

You can combine multiple attributes by providing a comma separated like "attribute1,attribute2". If multiple attributes are used, only businesses that satisfy all the attributes will be returned in search results. e.g., the attributes "hot_and_new,request_a_quote" will return businesses that are 'Hot and New', and offer 'Request a Quote'.

Suggestion to the search algorithm that the results be sorted by one of the these modes: best_match, rating, review_count or distance. The default is best_match. Note that specifying the sort_by is a suggestion (not strictly enforced) to Yelp's search, which considers multiple input parameters to return the most relevant results.

e.g., the rating sort is not strictly sorted by the rating value, but by an adjusted rating value that takes into account the number of ratings, similar to a Bayesian average. This is to prevent skewing results to businesses with a single review.

Determines the platform for mobile_link

The date for the reservation, format is YYYY-mm-dd

The time of the requested reservation, format is HH:MM

How many people are attending the reservation

Whether to filter out results that don't have openings matching the params

Return only businesses that service this job type (e.g. plumbing, HVAC repair). Acceptable job aliases can be found via the Get Jobs endpoint. If you need access to Get Jobs, please contact us.

Number of results to return.

Offset the list of returned results by this amount.