List Yelp business reviews

GET/v1/yelp/businesses/{alias}/reviews

2credits

Headers

Get your API key

x-api-keystringheader

API key (`sfk_...`)

Parameters

aliasstringrequiredpath

Yelp business alias or full business URL.

min 2 chars · max 2048 chars

categorystringrequiredquery

Review category to return.

one of: recommended, not_recommended, removed

cursorstringoptionalquery

Cursor returned with the previous page.

min 1 chars · max 512 chars

Response fields

Endpoint-specific response payload.

dataalias

string

Business alias from its Yelp URL.

min 2 chars · max 200 chars

datacategory

string

Review category to return.

one of: recommended, not_recommended, removed

datalistingbusinessId

stringnullable

datalistingbusinessName

stringnullable

datalistingoverallRating

numbernullable

≥ 0 · ≤ 5

datalistingisClaimed

booleannullable

datalistingrecommendedReviewCount

integernullable

≥ 0

datalistingnotRecommendedReviewCount

integernullable

≥ 0

datalistingremovedReviewCount

integernullable

≥ 0

Yelp's source-observed rating distribution. Buckets are null when counts are unavailable or malformed; their sum may differ from the separately reported recommended review total.

datalistingstarsfive

integernullable

≥ 0

datalistingstarsfour

integernullable

≥ 0

datalistingstarsthree

integernullable

≥ 0

datalistingstarstwo

integernullable

≥ 0

datalistingstarsone

integernullable

≥ 0

datalistingstarsTotal

integernullable

Sum of the five source-observed star buckets, when all buckets are available.

≥ 0

datalistingstarsReconciled

booleannullable

Whether the source star-bucket sum equals Yelp's separately reported recommended review count; null when either is unavailable.

datadiscoveredCount

integernullable

≥ 0

datareviews[]reviewId

stringnullable

datareviews[]userId

stringnullable

datareviews[]name

stringnullable

datareviews[]link

stringnullable

datareviews[]thumbnail

stringnullable

datareviews[]address

stringnullable

datareviews[]friends

integernullable

≥ 0

datareviews[]reviews

integernullable

≥ 0

datareviews[]photos

integernullable

≥ 0

datareviews[]eliteYear

stringnullable

datareviews[]rating

numbernullable

≥ 1 · ≤ 5

datareviews[]date

stringnullable

datareviews[]text

stringnullable

datareviews[]language

stringnullable

datareviews[]isUpdated

booleannullable

datareviews[]previousVersions[]date

stringnullable

datareviews[]previousVersions[]rating

numbernullable

≥ 1 · ≤ 5

datareviews[]previousVersions[]text

stringnullable

datareviews[]reactionshelpful

integernullable

≥ 0

datareviews[]reactionsthanks

integernullable

≥ 0

datareviews[]reactionsloveThis

integernullable

≥ 0

datareviews[]reactionsohNo

integernullable

≥ 0

datareviews[]reviewPhotos[]link

stringnullable

Yelp URL for the photo attached to this review, when available.

datareviews[]reviewPhotos[]caption

stringnullable

datareviews[]ownerReplies[]comment

stringnullable

datareviews[]ownerReplies[]date

stringnullable

datareviews[]ownerReplies[]ownername

stringnullable

datareviews[]ownerReplies[]ownerrole

stringnullable

datareviews[]reason

stringnullable

Pagination state for the current page.

datapagehasMore

boolean

Whether another page is available.

datapagenextCursor

stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId

string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged

integer

Credits charged for this request.

≥ 0

metaversion

string

Public API version that served the response.

one of: v1

metacached

booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

List Yelp business reviews

Headers

Code example

Responses