List Yelp business reviews
List public reviews for a Yelp business.
Headers
Get your API keyAPI key (`sfk_...`)
Yelp business alias or full business URL.
min 2 chars · max 2048 chars
Review category to return.
one of: recommended, not_recommended, removed
Cursor returned with the previous page.
min 1 chars · max 512 chars
Endpoint-specific response payload.
Business alias from its Yelp URL.
min 2 chars · max 200 chars
Review category to return.
one of: recommended, not_recommended, removed
≥ 0 · ≤ 5
Whether the business owner has claimed the Yelp page; null when Yelp did not report it.
≥ 0
≥ 0
≥ 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.
≥ 0
≥ 0
≥ 0
≥ 0
≥ 0
Sum of the five source-observed star buckets, when all buckets are available.
≥ 0
Whether the source star-bucket sum equals Yelp's separately reported recommended review count; null when either is unavailable.
≥ 0
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").
≥ 0
≥ 0
≥ 0
Four-digit year of the reviewer's current Yelp Elite badge (for example "2026"); null when the reviewer is not Elite.
≥ 1 · ≤ 5
≥ 1 · ≤ 5
≥ 0
≥ 0
≥ 0
≥ 0
Yelp URL for the photo attached to this review, when available.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.