Yelp

List Yelp business reviews

List public reviews for a Yelp business.

GET/v1/yelp/businesses/{alias}/reviews
2credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
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
64

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

Whether the business owner has claimed the Yelp page; null when Yelp did not report it.

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

Reviewer's home location as Yelp shows it. Recommended reviews give city and country (for example "Los Angeles, United States"); not-recommended and removed reviews give city and state or region (for example "Los Angeles, CA").

datareviews[]friends
integernullable

≥ 0

datareviews[]reviews
integernullable

≥ 0

datareviews[]photos
integernullable

≥ 0

datareviews[]eliteYear
stringnullable

Four-digit year of the reviewer's current Yelp Elite badge (for example "2026"); null when the reviewer is not Elite.

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

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/yelp/businesses/gary-danko-san-francisco/reviews?category=recommended" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yelp business reviews.