> ## 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 Business API

> Yelp business profiles: address, phone, ratings, attributes, photos, review insights, popular dishes and health inspections. By URL or location search.

`POST /v1/data/yelp/business/run`

**Pricing:** $0.002 per businesse ($2.00 per 1,000).

Paste Yelp business page URLs, or search a location by keyword (e.g. "coffee" in "San Francisco, CA") with optional sort, price, and feature filters.

## Ways to call it

* **URL**: set `urls`
* **Search**: set `location`, `keyword` (optional: `sort`, `priceLevels`, `features`, `limit`)

## Request

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

**urls** `string[]`

Yelp business page URL to fetch (e.g. [https://www.yelp.com/biz/molinari-delicatessen-san-francisco](https://www.yelp.com/biz/molinari-delicatessen-san-francisco)).

**location** `string`

City, region, or address to search within (e.g. "San Francisco, CA"). Used with Keyword.

Use together with `keyword`.

**keyword** `string`

What to search for in the location: a plain term, not a URL (e.g. coffee, restaurants, plumbers, dentist).

Use together with `location`.

**sort** `string` (default: recommended)

Search result ordering.

Allowed values: `recommended` (Recommended), `rating` (Highest Rated), `review_count` (Most Reviewed).

**priceLevels** `string[]`

Search filter: restrict to price bands \$ to \$\$\$\$.

Allowed values: `1` (\$), `2` (\$\$), `3` (\$\$\$), `4` (\$\$\$\$).

**features** `string[]`

Search filter: restrict to businesses with these features (e.g. Wheelchair Accessible, Dogs Allowed, Free WiFi).

**limit** `integer`

How many businesses to return, up to 1000. Each one costs a row, so this caps the bill as well as the output. Omit for as many as match.

Min `1`; max `1000`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/yelp/business/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",
      "https://www.yelp.com/biz/gary-danko-san-francisco",
      "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
    ]
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/yelp/business/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",
        "https://www.yelp.com/biz/gary-danko-san-francisco",
        "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
    ]
}},
)
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/business/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",
    "https://www.yelp.com/biz/gary-danko-san-francisco",
    "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
  ]
} }),
});
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 businesse, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `businessName` | Business Name | text |
| `businessUrl` | Business URL | url |
| `address` | Address | object |
| `neighborhoods` | Neighborhoods | array |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `phone` | Phone | phone |
| `website` | Website | url |
| `menuUrl` | Menu URL | url |
| `rating` | Rating | number |
| `totalReviews` | Total Reviews | number |
| `starBreakdown` | Star Breakdown | object |
| `reviewInsights` | Review Insights | object\_array |
| `reviewHighlights` | Review Highlights | object\_array |
| `popularDishes` | Popular Dishes | object\_array |
| `attributes` | Attributes | object\_array |
| `specialties` | Specialties | text |
| `summary` | Summary | text |
| `yearEstablished` | Year Established | number |
| `history` | History | text |
| `photos` | Photos | array |
| `healthInspections` | Health Inspections | object\_array |
| `hoursToday` | Hours (Today) | array |
| `qACount` | Q\&A Count | number |
| `qAContent` | Q\&A Content | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "yelp/business",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "rating": 4.5,
      "menuUrl": "https://www.sawadacoffee.com/chi/menu",
      "photos": [
        "https://s3-media0.fl.yelpcdn.com/bphoto/qJJnR-yE-Ux1FZN9HkBPGg/258s.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/kQ5DAPu0KB_55QqBTaMhhw/258s.jpg"
      ],
      "attributes": [
        {
          "attribute": "Bike Parking",
          "value": "Yes"
        },
        {
          "attribute": "Accepts Cryptocurrency",
          "value": "No"
        }
      ],
      "healthInspections": [],
      "qACount": 10,
      "starBreakdown": {
        "fiveStar": 758,
        "fourStar": 309,
        "threeStar": 77,
        "twoStar": 38,
        "oneStar": 18
      },
      "specialties": null,
      "hoursToday": [
        "8:00 AM - 4:00 PM"
      ],
      "neighborhoods": [
        "West Loop",
        "Near West Side"
      ],
      "businessName": "Sawada Coffee",
      "phone": "+1 312-344-1750",
      "summary": "Industrial-style coffee shop with picnic-style tables and shared seating, offering unique matcha and espresso blends like the Military Latte, located in the ...",
      "history": null,
      "totalReviews": 1200,
      "reviewInsights": [
        {
          "topic": "ambience",
          "sentiment": "POSITIVE",
          "positivePercent": 78,
          "neutralPercent": 15,
          "criticalPercent": 7,
          "reviewCount": 165
        },
        {
          "topic": "drinks",
          "sentiment": "POSITIVE",
          "positivePercent": 74,
          "neutralPercent": 9,
          "criticalPercent": 17,
          "reviewCount": 195
        }
      ],
      "qAContent": [
        {
          "question": "Is there outdoor seating?",
          "topAnswer": "Yes, it’s on the side of the building. Appears to be shared with the other businesses there.",
          "answerCount": 2
        },
        {
          "question": "Do they take Apple Pay?",
          "topAnswer": "Yep.",
          "answerCount": 1
        }
      ],
      "yearEstablished": null,
      "longitude": -87.64868874,
      "popularDishes": [
        {
          "name": "Military Latte",
          "price": null,
          "reviewCount": 460,
          "photoCount": 375,
          "photo": "https://s3-media0.fl.yelpcdn.com/bphoto/qJJnR-yE-Ux1FZN9HkBPGg/348s.jpg"
        },
        {
          "name": "Black Camo Latte",
          "price": null,
          "reviewCount": 131,
          "photoCount": 138,
          "photo": "https://s3-media0.fl.yelpcdn.com/bphoto/i2xiLmXs0FFR3kZYHDyNNA/348s.jpg"
        }
      ],
      "website": "http://www.sawadacoffee.com",
      "businessUrl": "https://www.yelp.com/biz/sawada-coffee-chicago",
      "latitude": 41.88359109,
      "reviewHighlights": [
        {
          "type": "phrase",
          "itemName": null,
          "price": null,
          "mentionedCount": 407,
          "snippet": "I tried the **Military Latte**, a unique blend of matcha, coffee, and cocoa powder that was surprisingly well-balanced."
        },
        {
          "type": "phrase",
          "itemName": null,
          "price": null,
          "mentionedCount": 263,
          "snippet": "25)-- **matcha** and espresso mixed together with milk I don't know what sorcery they put in this but it's SO GOOD!!"
        }
      ],
      "address": {
        "street": "112 N Green St",
        "city": "Chicago",
        "state": "IL",
        "zip": "60607",
        "country": "United States"
      }
    }
  ]
}
```

## Related APIs

For individual review text use [`yelp/reviews`](https://docs.mindcase.co/apis/yelp/reviews).


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