> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Yelp Reviews API

> Individual Yelp reviews: full text, rating, date, reviewer profile, reaction counts, photos and owner replies. One clean row per review.

`POST /v1/data/yelp/reviews/run`

**Pricing:** $0.00025 per review ($0.25 per 1,000).

Paste a Yelp business page URL; optionally cap the total number of reviews returned.

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**urls** `string` *required*

Yelp business page URL to scrape reviews from (e.g. [https://www.yelp.com/biz/katzs-delicatessen-new-york](https://www.yelp.com/biz/katzs-delicatessen-new-york)).

Format e.g. `https://www.yelp.com/biz/bix-san-francisco`.

**maxReviews** `integer`

Number of reviews to return in total. Use 0 for all available reviews.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/yelp/reviews/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": "https://www.yelp.com/biz/molinari-delicatessen-san-francisco",
    "maxReviews": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/yelp/reviews/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "urls": "https://www.yelp.com/biz/molinari-delicatessen-san-francisco",
    "maxReviews": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/yelp/reviews/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "urls": "https://www.yelp.com/biz/molinari-delicatessen-san-francisco",
  "maxReviews": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one review, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `reviewId` | Review ID | text |
| `rating` | Rating | rating |
| `reviewText` | Review Text | text |
| `reviewDate` | Review Date | text |
| `reviewUrl` | Review URL | url |
| `language` | Language | text |
| `translatedText` | Translated Text | text |
| `publicReply` | Public Reply | text |
| `photos` | Photos | array |
| `photoCaption` | Photo Caption | object\_array |
| `videos` | Videos | array |
| `totalReactions` | Total Reactions | number |
| `reactions` | Reactions | object |
| `firstReviewer` | First Reviewer | boolean |
| `reviewer` | Reviewer | object |
| `business` | Business | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "yelp/reviews",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "rating": 5,
      "reviewId": "EdRc1HWco_UP3IzFdIq9kg",
      "photoCaption": [],
      "photos": [],
      "business": {
        "name": "Molinari Delicatessen",
        "url": "https://www.yelp.com/biz/molinari-delicatessen-san-francisco",
        "id": "FmGF1B-Rpsjq1f5b56qMwg",
        "overallRating": 4.4,
        "totalReviews": 1603,
        "ratingDistribution": {
          "5_star": 1021,
          "4_star": 367,
          "3_star": 98,
          "2_star": 52,
          "1_star": 65
        }
      },
      "reviewUrl": "https://www.yelp.com/biz/molinari-delicatessen-san-francisco?hrid=EdRc1HWco_UP3IzFdIq9kg",
      "translatedText": null,
      "videos": [],
      "language": "en",
      "reviewDate": "2026-08-04T16:20:16-07:00",
      "reviewer": {
        "name": "Jimmy G.",
        "profilePhoto": "https://s3-media0.fl.yelpcdn.com/photo/iouBn41GkuFxTlbETQNgYA/180s.jpg",
        "eliteYears": [],
        "isEliteAllStar": false,
        "friendCount": 0,
        "reviewCount": 4,
        "photoCount": 1
      },
      "publicReply": null,
      "totalReactions": 0,
      "firstReviewer": false,
      "reactions": {
        "helpful": 0,
        "thanks": 0,
        "love_this": 0,
        "oh_no": 0
      },
      "reviewText": "Came here with my date to get some good ol' deli sammis, and we were NOT disappointed. We showed up towards the closing end of the restaurant hours so we wer..."
    }
  ]
}
```

## Related APIs

For the business profile use [`yelp/business`](https://docs.mindcase.co/apis/yelp/business).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.