Sign in
Businesses

Business Details

This endpoint returns detailed business content. Normally, you would get the Business ID from /v3/businesses/search, /v3/businesses/search/phone, /v3/transactions/{transaction_type}/search or /v3/autocomplete. To retrieve review excerpts for a business, please refer to our Reviews endpoint (/v3/businesses/{id}/reviews)

Note: at this time, the API does not return businesses without any reviews.

get/v3/businesses/{business_id_or_alias}

Path parameters

business_id_or_aliasstring required

A unique identifier for a Yelp Business. Can be either a 22-character Yelp Business ID, or a Yelp Business Alias.

Parameters

#/paths/~1v3~1businesses~1search/get/parameters/6 — unresolved $ref
#/paths/~1v3~1businesses~1search/get/parameters/12 — unresolved $ref

Response

A Business with the requested Id was returned.

idBusinessId required— unresolved $ref
aliasstring required

Unique Yelp alias of this business. Can contain unicode characters. Example: 'yelp-san-francisco'. Also see <a href="https://docs.developer.yelp.com/docs/fusion-faq#whats-the-difference-between-the-yelp-business-id-and-business-alias" target="_blank">What's the difference between the Yelp business ID and business alias?</a>

namestring required

Name of this business.

image_urlstring

URL of photo for this business

is_closedboolean

Whether business has been (permanently) closed

urlstring

URL for business page on Yelp.

review_countinteger

Number of reviews for this business.

{"stackTrail":"paths:/v3/businesses/{business_id_or_alias}:get:responses:200:content:application/json:schema:allOf:properties:rating","oasType":"schema","type":"unknown","description":"Rating for this business (value ranges from 1, 1.5, ... 4.5, 5)."}
transactionsstring[]

List of Yelp transactions that the business is registered for. Current supported values are pickup, delivery and restaurant_reservation.

pricestring

Price level of the business. Uses the currency symbol of the provided <code>locale</code>. Value for <code>en_US</code> is one of $, $$, $$$ or $$$$.

phonestring required

Phone number of the business.

display_phonestring required

Phone number of the business formatted nicely to be displayed to users. The format is the standard phone number format for the business's country.

{"stackTrail":"paths:/v3/businesses/{business_id_or_alias}:get:responses:200:content:application/json:schema:allOf:properties:distance","oasType":"schema","type":"unknown","description":"Distance in meters from the search location. This value is in meters(m) regardless of the locale."}
attributesobject

Various features or facilities provided by the business. Yelp Places Premium tier attributes, please apply here:

  • liked_by_vegetarians - is the business liked by vegetarians
  • liked_by_vegans - is the business liked by vegans
  • hot_and_new - has the business recently joined Yelp
is_claimedboolean required

Whether business has been claimed by a business owner

date_openedstring

Business opening date

date_closedstring

Business closing date

photosstring[] required

URLs of up to three photos of the business. <p> URLs of up to twelve photos of the business are available for Yelp Places Premium tier users </p>

photo_countinteger

Total number of photos <p>Yelp Places Premium tier, please apply here</p>

yelp_menu_urlstring

Business menu URL <p>Yelp Places Premium tier, please apply here</p>

cbsastring

Core based statistical area. <p>Yelp Insights Premium attribute, please apply here</p>