v1

latestOpenAPI 3.1.02026-07-248941352.6 KB
Reviews

Reviews

This endpoint returns up to three review excerpts for a given business ordered by <a href="https://www.yelp-support.com/article/How-is-the-order-of-reviews-determined?" target="_blank">Yelp's default sort order</a>.

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

To use this endpoint, make the GET request to the following URL with the ID of the business you want to get reviews for. Normally, you'll get the Business ID from <a href="https://docs.developer.yelp.com/reference/v3_business_search" target="_blank">/v3/businesses/search</a>, <a href="https://docs.developer.yelp.com/reference/v3_business_phone_search" target="_blank">/v3/businesses/search/phone</a>, <a href="https://docs.developer.yelp.com/reference/v3_transaction_search" target="_blank">/v3/transactions/{transaction_type}/search</a> or <a href="https://docs.developer.yelp.com/reference/v3_autocomplete" target="_blank">/v3/autocomplete</a>.

get/v3/businesses/{business_id_or_alias}/reviews

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.

Query parameters

localestring

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

offsetinteger

Offset the list of returned results by this amount.

limitinteger

Number of reviews to return.

sort_by'yelp_sort'

Sort reviews by.

Response

Returns up to three review excerpts for the given business.

totalinteger required

Total number of reviews returned

possible_languagesstring[] required

A list of languages for which the business has at least one review.