# 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/workflows/yelp
- Handle: `@yelp`
- Category: [Maps](https://fous.com/workflows/category/maps)
- Source website: https://yelp.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Yelp.

## Methods

### Get business

Operation `get_business`, version 1. 1 credit per call.

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 call.

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 call.

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.612157` |  |
| `businesses[].longitude` | number or null | `-122.338014` |  |
| `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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@yelp","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

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

### Is Fous affiliated with Yelp?

No. Fous is not affiliated with Yelp. This workflow reads the public yelp.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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

- [Google Maps API](https://fous.com/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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.
- [Google Play API](https://fous.com/workflows/google-play.md): Google Play helps people discover Android apps and games, view public listings and search results, read reviews when available by app and region, and see country-specific top charts.
- [All Maps workflows](https://fous.com/workflows/category/maps)