Yelp

Get autocomplete suggestions for businesses, categories, and search terms on Yelp based on partial text input. Returns matching businesses with their Yelp IDs, relevant category suggestions, and additional search term recommendations. Use this action when users are typing search queries and need real-time suggestions to refine their search before executing a full business search. Location coordinates (latitude/longitude) are optional but can improve suggestion relevance for geographic searches.

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.

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

Get detailed information about a specific Yelp category by its alias. Returns category metadata including the human-readable title, parent categories, and country availability lists. Use this action when you need to understand category hierarchies, check category availability by country, or get the proper display name for a category alias. The alias parameter must be a valid Yelp category identifier — use the list categories endpoint to discover available aliases.

Get detailed information about a specific Yelp event using its event ID. Returns comprehensive event information including dates, location, cost, attendance counts, and associated business details. Use this action when you need to retrieve full details about a specific event that you already have the ID for. Event IDs can be obtained from the search events or featured events endpoints.

Get the featured event for a given location on Yelp. Featured events are chosen by Yelp's community managers and represent notable happenings in the specified area. Use this action when you need to discover the highlighted or recommended event for a specific city, region, or coordinates. The returned `event_site_url` is the Yelp event page, not the event's own external website. Response fields such as `business_id`, `cost`, and `tickets_url` may be null; handle missing values explicitly.

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.

List all Yelp business categories across all locales by default. Returns category aliases, titles, parent relationships, and geographic availability. Use this action when you need to discover valid category aliases for filtering business searches or when building category-based navigation. The locale parameter allows filtering to categories available in specific regions while translating category names to the local language.

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.

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.

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.

Search for events on Yelp by location, categories, and other filters. Returns events happening in the specified area with details like time, cost, and attendance. Use this action when you need to find local events, activities, or happenings in a specific geographic area. Events can be filtered by category (music, food, sports), cost (free or paid), and time range. Results are sorted by popularity or start time and can be paginated using limit and offset parameters.