# Yelp

Yelp Fusion API provides access to business search, reviews, ratings, and local business information with rich data for location-based services

- **Category:** reviews
- **Auth:** NO_AUTH
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `YELP`
- **Version:** 20260211_00

## Tools

### Get Business Details

**Slug:** `YELP_GET_BUSINESS_DETAILS`

Get detailed information about a specific business on Yelp using its business ID or alias. Returns comprehensive business information including hours (in the business's local timezone), photos, reviews, and location details. The returned `url` field is the Yelp listing page, not the business's own website. Response fields such as `phone` and `website` may be null; handle missing values explicitly. Avoid many parallel calls — HTTP 429 throttling applies; limit concurrency to ~5 parallel requests with exponential backoff.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | Locale for the business details. Defaults to en_US. |
| `business_id` | string | Yes | IMPORTANT: This is NOT the business name. Must be the unique Yelp business ID (e.g., 'WavvLdfdP6g8aZTtbBQHTw') or URL-friendly alias (e.g., 'north-india-restaurant-san-francisco') obtained from YELP_SEARCH_BUSINESSES or YELP_SEARCH_BY_PHONE. Business names like 'Almar Cleaners' or 'Pizza Hut' will be rejected. Use the search action first to find the business and get its ID or alias. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Business Reviews

**Slug:** `YELP_GET_BUSINESS_REVIEWS`

Get reviews for a specific business on Yelp using its business ID or alias. Returns up to 3 review excerpts for the business.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | Locale for the reviews. Defaults to en_US. If reviews list is empty but total > 0, the locale may be mismatched — check possible_languages in the response and set locale explicitly to match. |
| `sort_by` | string | No | Sort reviews by: yelp_sort (default), newest, or oldest. |
| `business_id` | string | Yes | Yelp business ID or alias. Can be the unique ID or the business alias from search results. Must be obtained first via a business search tool (e.g., search by name or phone); passing a plain business name directly is not supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Review Highlights

**Slug:** `YELP_GET_REVIEW_HIGHLIGHTS`

Get review highlights for a specific business on Yelp using its business ID or alias. Returns summarized key points and themes from customer reviews. IMPORTANT: This endpoint requires Yelp Places API Premium Plan access. Without Premium Plan, requests will return a 403 NOT_AUTHORIZED error. For basic review access, consider using the Get Business Reviews action instead, which is available on Enhanced and Premium plans. Note: Get Business Reviews returns at most 3 recent reviews per call, while this action synthesizes themes across the full review history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Number of review highlights to return. Maximum is 10. |
| `business_id` | string | Yes | Yelp business ID or alias. Use the 'id' or 'alias' field from Search Businesses or Get Business Details response. Examples: unique ID like 'WavvLdfdP6g8aZTtbBQHTw' or alias like 'north-india-restaurant-san-francisco'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search and Chat

**Slug:** `YELP_SEARCH_AND_CHAT`

Chat with Yelp's AI assistant to search for businesses, get recommendations, and ask questions. This action provides a conversational interface to Yelp's AI that can: - Search for businesses by type, location, and criteria (e.g., "best Italian restaurants near Times Square") - Answer questions about specific businesses (e.g., "what are the hours for The Purple Pig?") - Provide recommendations based on user preferences - Maintain conversation context when chat_id is provided for follow-up questions The response includes the AI's natural language answer along with detailed business data including ratings, reviews, locations, photos, and attributes for any mentioned businesses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Natural language query to ask Yelp's AI assistant. Can be questions about finding businesses (e.g., 'best sushi in Manhattan'), details about specific businesses (e.g., 'what are the hours for Purple Pig Chicago'), or follow-up questions in an ongoing conversation. |
| `chat_id` | string | No | Optional chat session ID returned from a previous request. Pass this to continue a conversation and maintain context across multiple queries. If not provided, starts a new conversation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Businesses

**Slug:** `YELP_SEARCH_BUSINESSES`

Search for businesses on Yelp by location, term, categories, and other filters. Returns at most 50 results per call; use offset to paginate. Overly restrictive filter combinations (categories, price, radius) can yield zero results — loosen iteratively. Results may include businesses from adjacent areas; post-process on location.city or distance for strict boundaries. The returned url field is the Yelp listing page, not the business's own website. Rapid parallel calls can trigger HTTP 429 — apply exponential backoff.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `term` | string | No | Search term (e.g. food, restaurants, bars, etc.). If not provided, will search for all businesses. |
| `limit` | integer | No | Number of businesses to return. Maximum is 50. |
| `price` | string | No | Price filter: 1 = $, 2 = $$, 3 = $$$, 4 = $$$$. Comma-separated for multiple. Must use numeric strings only (e.g., '1,2') — currency symbols or words silently fail. Note: the price field may be absent from some results; guard against missing values to avoid dropping valid businesses. |
| `locale` | string | No | Locale for the search results. Defaults to en_US. |
| `offset` | integer | No | Offset for pagination. Used to get more results beyond the limit. Hard cap around offset 1000; stop paginating when a page returns fewer items than requested. |
| `radius` | integer | No | Search radius in meters. Maximum is 40000 meters (25 miles). The distance field in results is also in meters and must be converted for display. |
| `open_at` | integer | No | Filter for businesses open at a specific Unix timestamp. |
| `sort_by` | string | No | Sort businesses by: best_match, rating, review_count, or distance. |
| `latitude` | number | No | Latitude coordinate for search location. Must be provided with longitude. Use coordinates instead of location names for regions where name-based search returns LOCATION_NOT_FOUND (e.g., South Africa, most of Africa). Note: unsupported regions may have no business data even with valid coordinates. Provide EITHER 'location' OR both 'latitude' and 'longitude', not both. If both are provided, coordinates take precedence. |
| `location` | string | No | Location to search for businesses. Can be an address, city, state, or zip code. Yelp operates in 32 countries including US, Canada, UK, Australia, Japan, and most of Europe. Countries NOT supported include India, China, South Africa, most of Africa, and parts of Asia - searches in unsupported regions will return LOCATION_NOT_FOUND errors for city names. Use coordinates (latitude/longitude) for unsupported regions, though business data may be unavailable. Provide EITHER 'location' OR both 'latitude' and 'longitude', not both. If coordinates are also provided, coordinates will be used instead of location. |
| `open_now` | boolean | No | Filter for businesses that are open now. |
| `longitude` | number | No | Longitude coordinate for search location. Must be provided with latitude. Use coordinates instead of location names for regions where name-based search returns LOCATION_NOT_FOUND (e.g., South Africa, most of Africa). Note: unsupported regions may have no business data even with valid coordinates. Provide EITHER 'location' OR both 'latitude' and 'longitude', not both. If both are provided, coordinates take precedence. |
| `attributes` | string | No | Additional filters. Comma-separated list of attributes. |
| `categories` | string | No | Categories to filter by. Comma-separated list of category aliases. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Business by Phone

**Slug:** `YELP_SEARCH_BY_PHONE`

Search for a business by phone number on Yelp. Returns business data including business_id, required by YELP_GET_BUSINESS_DETAILS, YELP_GET_BUSINESS_REVIEWS, and YELP_GET_REVIEW_HIGHLIGHTS. Empty results are inconclusive due to incomplete Yelp coverage.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Phone number to search for in E.164 format. Must include country code (e.g., +1 for US, +44 for UK). Example: +14159083801 for a US number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |