# Yelp Business Reviews API Documentation

Retrieve public reviews for a Yelp business, 10 per page: review id, public url, star rating, full text, language, creation time (ISO 8601, UTC), author name, location, review and friend counts, reaction counts and photo urls. Sort by relevance, newest, oldest, highest, lowest or elite and filter by star rating. Page with the after cursor from the previous response next_after field. A business without reviews is a successful response with an empty list.

- **Documentation:** [https://scrappa.co/docs/yelp-api/yelp_reviews](https://scrappa.co/docs/yelp-api/yelp_reviews)
- **API group:** Yelp API
- **Endpoint:** `GET https://scrappa.co/api/yelp/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `business` | string | Yes | Yelp business alias or the 22 character business id. Example: gary-danko-san-francisco. |
| `sort` | string | No | One of relevance, newest, oldest, highest, lowest, elite. Defaults to relevance. |
| `rating` | integer | No | Only return reviews with this star rating, 1 to 5. |
| `after` | string | No | Cursor from the previous response next_after field. Omit for the first page. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/yelp/reviews?business=gary-danko-san-francisco&sort=newest"
```

## Example response

```json
{
    "success": true,
    "data": {
        "business": {
            "encid": "WavvLdfdP6g8aZTtbBQHTw",
            "alias": "gary-danko-san-francisco",
            "name": "Gary Danko",
            "url": "https://www.yelp.com/biz/gary-danko-san-francisco"
        },
        "review_count": 6148,
        "total": 6149,
        "reviews": [
            {
                "id": "uP7LSWnXOFDQZs4uSMry4A",
                "url": "https://www.yelp.com/biz/gary-danko-san-francisco?hrid=uP7LSWnXOFDQZs4uSMry4A",
                "rating": 5,
                "text": "The Fleet Week Weekend San Francisco Edition:",
                "language": "en",
                "created_at": "2026-10-11T15:39:21Z",
                "author": {
                    "id": "QbHmGJVS_Ztw5YtpCl3p6A",
                    "name": "Juan V.",
                    "location": "San Francisco, CA",
                    "url": "https://www.yelp.com/user_details?userid=QbHmGJVS_Ztw5YtpCl3p6A",
                    "review_count": 2028,
                    "friend_count": 5000
                },
                "helpful_count": 11,
                "thanks_count": 4,
                "love_this_count": 8,
                "photos": [
                    "https://s3-media0.fl.yelpcdn.com/bphoto/HyRE7wLRiyc9LWh_2r0_lA/o.jpg"
                ]
            }
        ],
        "has_more": true,
        "next_after": "eyJ2ZXJzaW9uIjoxLCJ0eXBlIjoib2Zmc2V0Iiwib2Zmc2V0Ijo5fQ"
    },
    "meta": {
        "endpoint_family": "business_reviews",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Yelp business does not exist. This response is not billable. |
| 502 | Invalid Source Response | The upstream answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)