# Yelp API

> Yelp returns local business listings, public profiles, and reviews as a workflow and API.

Yelp’s Search businesses method returns local listings based on business type or name and location. Get business returns a public profile based on business name and city or Yelp link. Get business reviews returns reviews based on business name and location or Yelp link, with a selected review order.

- Page: https://fous.com/tools/yelp
- Handle: `@yelp`
- Category: [Maps](https://fous.com/tools/category/maps)
- Source website: https://yelp.com
- Last verified: Sep 29, 2026

## Methods

### Get business

Operation `get_business`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the public Yelp profile of one business by name and city or Yelp link. A name must match a listing in the city; unavailable details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `location` | string | yes | `"San Francisco"` | City of the business, for example San Francisco. |
| `business_name` | string | yes | `"https://www.yelp.com/biz/tartine-bakery-san-francisco-3"` | Business name or Yelp business link, for example Tartine Bakery. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "business_name",
    "location"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "City of the business, for example San Francisco.",
      "examples": [
        "San Francisco",
        "Seattle"
      ]
    },
    "business_name": {
      "type": "string",
      "description": "Business name or Yelp business link, for example Tartine Bakery.",
      "examples": [
        "https://www.yelp.com/biz/tartine-bakery-san-francisco-3",
        "Tartine Bakery",
        "Shiro's"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "location": "San Francisco",
      "business_name": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
    },
    {
      "location": "San Francisco",
      "business_name": "Tartine Bakery"
    },
    {
      "location": "Seattle",
      "business_name": "Shiro's"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `name` | string | `"Tartine Bakery"` |  |
| `rating` | number or null | `4.2` |  |
| `address` | string or null | `"600 Guerrero St, San Francisco, CA 94110"` |  |
| `website` | string or null | `"https://tartinebakery.com/san-francisco/bakery"` |  |
| `latitude` | number or null | `37.761665` |  |
| `open_now` | string or null | `"no"` |  |
| `amenities` | array |  |  |
| `amenities[].name` | string | `"Offers delivery"` |  |
| `amenities[].available` | string | `"yes"` |  |
| `longitude` | number or null | `-122.424242` |  |
| `yelp_link` | string | `"https://www.yelp.com/biz/tartine-bakery-san-francisco-3"` |  |
| `categories` | array |  |  |
| `photo_links` | array |  |  |
| `price_level` | string or null | `"$$"` |  |
| `phone_number` | string or null | `"(415) 487-2600"` |  |
| `review_count` | integer or null | `9202` |  |
| `opening_hours` | object |  |  |
| `opening_hours.friday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `opening_hours.monday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `opening_hours.sunday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `opening_hours.tuesday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `opening_hours.saturday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `opening_hours.thursday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `opening_hours.wednesday` | string or null | `"7:30 AM - 6:00 PM"` |  |
| `business_alias` | string or null | `"tartine-bakery-san-francisco-3"` |  |
| `claimed_by_owner` | string or null | `"yes"` |  |

**Example input**

```json
{
  "location": "San Francisco",
  "business_name": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
}
```

**Example output**

```json
{
  "name": "Tartine Bakery",
  "rating": 4.2,
  "address": "600 Guerrero St, San Francisco, CA 94110",
  "website": "https://tartinebakery.com/san-francisco/bakery",
  "latitude": 37.761665,
  "open_now": "no",
  "amenities": [
    {
      "name": "Offers delivery",
      "available": "yes"
    },
    {
      "name": "Offers take-out",
      "available": "yes"
    },
    {
      "name": "Takes reservations",
      "available": "no"
    }
  ],
  "longitude": -122.424242,
  "yelp_link": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3",
  "categories": [
    "Bakeries",
    "Cafes",
    "Desserts"
  ],
  "photo_links": [
    "https://s3-media0.fl.yelpcdn.com/bphoto/26rwwIIRoi81hlzqdpzDYA/l.jpg",
    "https://s3-media0.fl.yelpcdn.com/bphoto/_IUts3tObOAikcqvNbsfDg/l.jpg",
    "https://s3-media0.fl.yelpcdn.com/bphoto/gl2Sl5DHgyIDRH8nnSNDZA/l.jpg"
  ],
  "price_level": "$$",
  "phone_number": "(415) 487-2600",
  "review_count": 9202,
  "opening_hours": {
    "friday": "7:30 AM - 6:00 PM",
    "monday": "7:30 AM - 6:00 PM",
    "sunday": "7:30 AM - 6:00 PM",
    "tuesday": "7:30 AM - 6:00 PM",
    "saturday": "7:30 AM - 6:00 PM",
    "thursday": "7:30 AM - 6:00 PM",
    "wednesday": "7:30 AM - 6:00 PM"
  },
  "business_alias": "tartine-bakery-san-francisco-3",
  "claimed_by_owner": "yes"
}
```

### Get business reviews

Operation `get_business_reviews`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get Yelp reviews for a business by name and location or Yelp link, with the selected review order. Returns up to 60 publicly shown reviews; owner replies are included when shown.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"lowest_rated"` | Review order, for example newest. |
| `location` | string | yes | `"Yountville, CA"` | City or area of the business, for example New York. |
| `max_reviews` | integer | no | `10` | Maximum number of reviews to return, for example 20. |
| `business_name` | string | yes | `"The French Laundry"` | Business name or Yelp business page link, for example Katz's Delicatessen. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "business_name",
    "location"
  ],
  "properties": {
    "sort": {
      "enum": [
        "recommended",
        "newest",
        "highest_rated",
        "lowest_rated"
      ],
      "type": "string",
      "default": "recommended",
      "description": "Review order, for example newest.",
      "examples": [
        "lowest_rated",
        "newest",
        "highest_rated"
      ]
    },
    "location": {
      "type": "string",
      "description": "City or area of the business, for example New York.",
      "examples": [
        "Yountville, CA",
        "New York"
      ]
    },
    "max_reviews": {
      "type": "integer",
      "default": 20,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum number of reviews to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        10,
        25,
        60
      ]
    },
    "business_name": {
      "type": "string",
      "description": "Business name or Yelp business page link, for example Katz's Delicatessen.",
      "examples": [
        "The French Laundry",
        "https://www.yelp.com/biz/katzs-delicatessen-new-york",
        "Katz's Delicatessen"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "sort": "lowest_rated",
      "location": "Yountville, CA",
      "max_reviews": 10,
      "business_name": "The French Laundry"
    },
    {
      "sort": "newest",
      "location": "New York",
      "max_reviews": 25,
      "business_name": "https://www.yelp.com/biz/katzs-delicatessen-new-york"
    },
    {
      "sort": "highest_rated",
      "location": "Yountville, CA",
      "max_reviews": 60,
      "business_name": "The French Laundry"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `address` | string or null | `"6640 Washington St\nThomas Keller's Flagship Restaurant\nYountville, CA 94599"` |  |
| `reviews` | array |  |  |
| `reviews[].stars` | integer or null | `1` |  |
| `reviews[].review_id` | string or null | `"9n_HaPtgmALe3M3Qxlslmw"` |  |
| `reviews[].review_url` | string | `"https://www.yelp.com/biz/the-french-laundry-yountville-7?hrid=9n_HaPtgmALe3M3Qxlslmw"` |  |
| `reviews[].owner_reply` | string or null |  |  |
| `reviews[].review_date` | string or null | `"2026-09-28"` |  |
| `reviews[].review_text` | string or null | `"I called to ask for help making a reservation as I am visuslly disabled. Aaron, whom andwered the phone, laughed and hu` |  |
| `reviews[].reviewer_name` | string or null | `"Marmar S."` |  |
| `reviews[].reviewer_location` | string or null | `"Los Angeles, CA"` |  |
| `business_url` | string | `"https://www.yelp.com/biz/the-french-laundry-yountville-7"` |  |
| `business_name` | string | `"The French Laundry"` |  |
| `total_reviews` | integer or null | `3177` |  |
| `overall_rating` | number or null | `4.3` |  |

**Example input**

```json
{
  "sort": "lowest_rated",
  "location": "Yountville, CA",
  "max_reviews": 10,
  "business_name": "The French Laundry"
}
```

**Example output**

```json
{
  "address": "6640 Washington St\nThomas Keller's Flagship Restaurant\nYountville, CA 94599",
  "reviews": [
    {
      "stars": 1,
      "review_id": "9n_HaPtgmALe3M3Qxlslmw",
      "review_url": "https://www.yelp.com/biz/the-french-laundry-yountville-7?hrid=9n_HaPtgmALe3M3Qxlslmw",
      "owner_reply": null,
      "review_date": "2026-09-28",
      "review_text": "I had high expectations for The French Laundry, and while the service was genuinely excellent (attentive, polished, and professional), the food simply didn't deliver. Many of the dishes lacked flavor,…",
      "reviewer_name": "Marmar S.",
      "reviewer_location": "Los Angeles, CA"
    },
    {
      "stars": 1,
      "review_id": "Q0i9T5ngj_fRjHzYK6ecqw",
      "review_url": "https://www.yelp.com/biz/the-french-laundry-yountville-7?hrid=Q0i9T5ngj_fRjHzYK6ecqw",
      "owner_reply": null,
      "review_date": "2026-09-18",
      "review_text": "I called to ask for help making a reservation as I am visuslly disabled. Aaron, whom andwered the phone, laughed and hung up on me. Buzarre.",
      "reviewer_name": "Robert Andrew Schaub ..",
      "reviewer_location": "San Francisco, CA"
    },
    {
      "stars": 1,
      "review_id": "jVYQnCD6n-5xaYblVoPfSQ",
      "review_url": "https://www.yelp.com/biz/the-french-laundry-yountville-7?hrid=jVYQnCD6n-5xaYblVoPfSQ",
      "owner_reply": null,
      "review_date": "2026-08-25",
      "review_text": "Feel compelled to write this review. We were there for Cinco de Mayo and the service was impeccable and the place is beautiful, but I was shocked at the quality of the food.\n\nThe oysters and  pearls w…",
      "reviewer_name": "Bryan R.",
      "reviewer_location": "Fort Lauderdale, FL"
    }
  ],
  "business_url": "https://www.yelp.com/biz/the-french-laundry-yountville-7",
  "business_name": "The French Laundry",
  "total_reviews": 3177,
  "overall_rating": 4.3
}
```

### Search businesses

Operation `search_businesses`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find local Yelp businesses by type or name and location, in Yelp order without sponsored listings. For lists over 20, phone numbers, full addresses and coordinates may be missing after the first 20.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"most_reviewed"` | Order listings, for example highest_rated. |
| `what` | string | yes | `"plumber"` | Business type or name, for example sushi. |
| `price` | string | no | `"$$"` | Price level, for example $$. |
| `where` | string | yes | `"Portland, OR"` | City, neighborhood or address, for example Seattle, WA. |
| `open_now` | string | no | `"yes"` | Only businesses open now, for example yes. |
| `max_results` | integer | no | `3` | Maximum number of businesses to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "what",
    "where"
  ],
  "properties": {
    "sort": {
      "enum": [
        "recommended",
        "highest_rated",
        "most_reviewed"
      ],
      "type": "string",
      "default": "recommended",
      "description": "Order listings, for example highest_rated.",
      "examples": [
        "most_reviewed",
        "highest_rated"
      ]
    },
    "what": {
      "type": "string",
      "description": "Business type or name, for example sushi.",
      "examples": [
        "plumber",
        "sushi"
      ]
    },
    "price": {
      "enum": [
        "any",
        "$",
        "$$",
        "$$$",
        "$$$$"
      ],
      "type": "string",
      "default": "any",
      "description": "Price level, for example $$.",
      "examples": [
        "$$"
      ]
    },
    "where": {
      "type": "string",
      "description": "City, neighborhood or address, for example Seattle, WA.",
      "examples": [
        "Portland, OR",
        "Seattle, WA"
      ]
    },
    "open_now": {
      "enum": [
        "yes",
        "no"
      ],
      "type": "string",
      "default": "no",
      "description": "Only businesses open now, for example yes.",
      "examples": [
        "yes"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of businesses to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "sort": "most_reviewed",
      "what": "plumber",
      "where": "Portland, OR",
      "max_results": 3
    },
    {
      "what": "sushi",
      "where": "Seattle, WA"
    },
    {
      "sort": "highest_rated",
      "what": "sushi",
      "price": "$$",
      "where": "Seattle, WA",
      "open_now": "yes",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `businesses` | array |  |  |
| `businesses[].name` | string | `"Rescue Rooter"` |  |
| `businesses[].rating` | number or null | `1.8` | Rating out of five. |
| `businesses[].address` | string or null | `"12430 SE Capps Rd, Clackamas, OR 97015"` |  |
| `businesses[].latitude` | number or null | `47.614778` |  |
| `businesses[].longitude` | number or null | `-122.347327` |  |
| `businesses[].yelp_link` | string or null | `"https://www.yelp.com/biz/rescue-rooter-clackamas-3?osq=plumber&override_cta=Get+pricing+%26+availability"` |  |
| `businesses[].categories` | array |  |  |
| `businesses[].price_level` | string or null | `"$$$$"` |  |
| `businesses[].neighborhood` | string or null | `"Southwest Portland"` |  |
| `businesses[].phone_number` | string or null | `"(503) 486-4925"` |  |
| `businesses[].review_count` | integer or null | `160` |  |
| `businesses[].business_alias` | string or null | `"rescue-rooter-clackamas-3"` |  |
| `businesses[].review_snippet` | string or null | `"I would caution anyone in need of plumbing services to steer clear of the shysters at Rescue Rooter."` |  |

**Example input**

```json
{
  "sort": "most_reviewed",
  "what": "plumber",
  "where": "Portland, OR",
  "max_results": 3
}
```

**Example output**

```json
{
  "businesses": [
    {
      "name": "Rescue Rooter",
      "rating": 1.8,
      "address": "12430 SE Capps Rd, Clackamas, OR 97015",
      "latitude": null,
      "longitude": null,
      "yelp_link": "https://www.yelp.com/biz/rescue-rooter-clackamas-3?osq=plumber&override_cta=Get+pricing+%26+availability",
      "categories": [
        "Plumbing",
        "Water Heater Installation/Repair"
      ],
      "price_level": null,
      "neighborhood": null,
      "phone_number": "(503) 486-4925",
      "review_count": 160,
      "business_alias": "rescue-rooter-clackamas-3",
      "review_snippet": "I would caution anyone in need of plumbing services to steer clear of the shysters at Rescue Rooter."
    },
    {
      "name": "John D Plumbing",
      "rating": 4.7,
      "address": "Portland, OR 97223",
      "latitude": null,
      "longitude": null,
      "yelp_link": "https://www.yelp.com/biz/john-d-plumbing-portland-3?osq=plumber&override_cta=Get+pricing+%26+availability",
      "categories": [
        "Plumbing",
        "Water Heater Installation/Repair"
      ],
      "price_level": null,
      "neighborhood": "Southwest Portland",
      "phone_number": "(503) 317-2233",
      "review_count": 147,
      "business_alias": "john-d-plumbing-portland-3",
      "review_snippet": "I will definitely hire him again when I need plumbing services in the future."
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@yelp",
  "visibility": "public",
  "operation": "get_business",
  "version": 1,
  "input": {
    "location": "San Francisco",
    "business_name": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@yelp\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_business\",\n  \"version\": 1,\n  \"input\": {\n    \"location\": \"San Francisco\",\n    \"business_name\": \"https://www.yelp.com/biz/tartine-bakery-san-francisco-3\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@yelp",
  "visibility": "public",
  "operation": "get_business",
  "version": 1,
  "input": {
    "location": "San Francisco",
    "business_name": "https://www.yelp.com/biz/tartine-bakery-san-francisco-3"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/yelp`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_business`: Get business. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_business_reviews`: Get business reviews. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_businesses`: Search businesses. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-yelp https://api.fous.com/mcp/tools/yelp --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare local businesses by rating, price, and review count
- Find businesses in a city or neighborhood
- Check a business’s hours, amenities, and contact details
- Analyze customer reviews and owner replies
- Build local business shortlists by category

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Yelp tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Yelp account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from yelp.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### Which businesses match a type and location?

Search businesses finds local listings by business type or name and location.

### What are a business’s hours and amenities?

Get business returns a public profile with opening hours and amenities when available.

### What are customers saying about a business?

Get business reviews returns publicly shown reviews, with owner replies when shown.

## Related

- [Yellow Pages API](https://fous.com/tools/yellow-pages.md): Find local US businesses and their contact details on Yellow Pages.
- [Google Maps API](https://fous.com/tools/google-maps.md): Google Maps returns nearby places, public place details, up to 100 public reviews, and up to three routes; transit options vary by departure time.
- [Tripadvisor API](https://fous.com/tools/tripadvisor.md): Tripadvisor provides traveler-ranked first-page city listings of attractions, restaurants and hotels, plus latest reviews; hotel prices and booking sites depend on supplied stay dates and availability.
- [Better Business Bureau API](https://fous.com/tools/better-business-bureau.md): Better Business Bureau provides business profiles, ratings, accreditation, reviews, alerts, and published complaints, with complaint details limited to those publicly displayed and newest first.
- [Trustpilot API](https://fous.com/tools/trustpilot.md): Trustpilot provides company ratings, reply and location details when available, recent public reviews, and company search results with ratings, review counts, categories, locations, and links.
- [Booking.com API](https://fous.com/tools/booking-com.md): Booking.com helps find stays, property details and public guest reviews; prices and cancellation terms depend on selected dates, and displayed prices may exclude taxes and fees.
- [Walmart API](https://fous.com/tools/walmart.md): Walmart helps shoppers find products from Walmart and marketplace sellers, view details, prices, ratings and reviews; availability uses Walmart’s default location, not ZIP codes.
- [Apple App Store API](https://fous.com/tools/apple-app-store.md): Apple App Store returns public app listings, keyword search, ratings, prices, listed purchases, country-specific reviews and visible replies, and up to 200 ranked chart apps.
- [All Maps tools](https://fous.com/tools/category/maps)