# Yelp Business

Extract Yelp business profiles — name, address, phone, website, ratings, attributes, photos, review insights, popular dishes, and health inspections — by business URL or by location + keyword search. One clean row per business.

**Pricing:** $0.5 / 1k businesses

**Endpoint:** `POST /api/v1/agents/yelp/business/run`

**Auth:** `Authorization: Bearer mk_live_...`

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | array | No | Yelp business page URLs, one per line (e.g. https://www.yelp.com/biz/molinari-delicatessen-san-francisco). |
| `location` | string | No | City, region, or address to search within (e.g. "San Francisco, CA"). Used with Keyword. |
| `keyword` | string | No | What to search for in the location — a plain term, not a URL (e.g. coffee, restaurants, plumbers, dentist). |
| `sort` | string | No | Search result ordering. |
| `priceLevels` | array | No | Search filter: restrict to price bands $ to $$$$. |
| `features` | array | No | Search filter: restrict to businesses with these features (e.g. Wheelchair Accessible, Dogs Allowed, Free WiFi). |
| `limit` | integer | No | Search result pages per query (~80 businesses per page). |

## Example

```bash
curl -X POST https://api.mindcase.co/api/v1/agents/yelp/business/run \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{}}'
```

```python
import requests

resp = requests.post(
    "https://api.mindcase.co/api/v1/agents/yelp/business/run",
    headers={"Authorization": "Bearer mk_live_YOUR_API_KEY"},
    json={"params": {}},
)
data = resp.json()
```

## Get the results

`run` is async and returns a `job_id`. Poll until `status` is `completed`, then read the rows:

```bash
# 1) check status
curl https://api.mindcase.co/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"

# 2) when status == completed, fetch the rows
curl https://api.mindcase.co/api/v1/jobs/JOB_ID/results \
  -H "Authorization: Bearer mk_live_YOUR_API_KEY"
```

Full API reference (auth, jobs, balance, SDKs, MCP): https://mindcase.co/skills.md

## Response columns

| Field | Display 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 |
| `ratings` | Ratings | 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 |