Search

get

https://api.yelp.com/v3/businesses/search

This endpoint returns up to 240 businesses with some basic information based on the provided search criteria.

Explore our new Yelp AI API for conversational search experiences. Try it for free in our playground and see real-time conversational responses in action.

Note: The API does not return businesses without any reviews.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
This endpoint is part of Yelp Places API, visit Yelp Places API to learn more.

Query Params

location

string

length between 1 and 250

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.

latitude

number

-90 to 90

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

longitude

number

-180 to 180

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

term

string

length ≤ 300

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.

radius

integer

0 to 40000

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

array of strings

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").

categories

locale

string

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

price

array of integers

length ≤ 4

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 $$$.

price

open_now

boolean

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

open_at

integer

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.

attributes

array of strings

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'.

attributes

sort_by

string

enum

Defaults to best_match

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.

Allowed:

device_platform

string

enum

Determines the platform for mobile_link

Allowed:

reservation_date

string

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

reservation_time

string

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

reservation_covers

integer

1 to 10

How many people are attending the reservation

matches_party_size_param

boolean

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

job_alias

string

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.

limit

integer

0 to 50

Defaults to 20

Number of results to return.

offset

integer

0 to 1000

Offset the list of returned results by this amount.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json